@classytic/crm 0.3.0 → 0.5.1

package/dist/index.js

@@ -1,11 +1,104 @@
 import { t as __exportAll } from "./chunk.js";
 import { Schema } from "mongoose";
-import { Repository, aggregateHelpersPlugin, methodRegistryPlugin, multiTenantPlugin } from "@classytic/mongokit";
+import { Repository, aggregateHelpersPlugin, isDuplicateKeyError, methodRegistryPlugin, multiTenantPlugin } from "@classytic/mongokit";
 import { createEvent as createEvent$1, matchEventPattern } from "@classytic/primitives/events";
 import { assertAndClaim, defineStateMachine } from "@classytic/primitives/state-machine";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
 import { appendStatus, lastTransitionTo, latestEntry, timeInStatus } from "@classytic/primitives/status-history";
+//#region src/core/errors.ts
+/**
+* CRM error vocabulary. Hosts catch `CrmError` at API edges.
+*/
+var CrmError = class extends Error {
+	code;
+	details;
+	constructor(code, message, details) {
+		super(message);
+		this.name = "CrmError";
+		this.code = code;
+		if (details !== void 0) this.details = details;
+	}
+};
+var NotFoundError = class extends CrmError {
+	constructor(kind, id) {
+		super(`${kind.toUpperCase()}_NOT_FOUND`, `${kind} '${id}' not found`, {
+			kind,
+			id
+		});
+	}
+};
+var InvalidLeadTransitionError = class extends CrmError {
+	constructor(details) {
+		super("INVALID_LEAD_TRANSITION", `Lead ${details.leadId} cannot move from '${details.from}' to '${details.to}'`, details);
+	}
+};
+var InvalidOpportunityTransitionError = class extends CrmError {
+	constructor(details) {
+		super("INVALID_OPPORTUNITY_TRANSITION", `Opportunity ${details.opportunityId} cannot move from '${details.from}' to '${details.to}'`, details);
+	}
+};
+var InvalidActivityTransitionError = class extends CrmError {
+	constructor(details) {
+		super("INVALID_ACTIVITY_TRANSITION", `Activity ${details.activityId} cannot move from '${details.from}' to '${details.to}'`, details);
+	}
+};
+var StageNotInPipelineError = class extends CrmError {
+	constructor(details) {
+		super("STAGE_NOT_IN_PIPELINE", `Stage '${details.stageId}' is not defined on pipeline '${details.pipelineId}'`, details);
+	}
+};
+var LeadAlreadyConvertedError = class extends CrmError {
+	constructor(leadId) {
+		super("LEAD_ALREADY_CONVERTED", `Lead '${leadId}' is already converted`, { leadId });
+	}
+};
+var DuplicateLeadError = class extends CrmError {
+	constructor(details) {
+		super("DUPLICATE_LEAD", `A lead with this email / phone already exists`, details);
+	}
+};
+var CrmModelCollisionError = class extends CrmError {
+	constructor(modelName) {
+		super("CRM_MODEL_COLLISION", `Mongoose model '${modelName}' is already registered on this connection. Another engine (or a hot reload) owns it. Pass { forceRecreate: true } to createCrm() for test/hot-reload fixtures, or use a separate mongoose connection per engine in production (PACKAGE_RULES §21).`, { modelName });
+	}
+};
+var EmptyPipelineError = class extends CrmError {
+	constructor(pipelineId) {
+		super("EMPTY_PIPELINE", `Pipeline '${pipelineId}' has no stages`, { pipelineId });
+	}
+};
+var InvalidCampaignTransitionError = class extends CrmError {
+	constructor(details) {
+		super("INVALID_CAMPAIGN_TRANSITION", `Campaign ${details.campaignId} cannot move from '${details.from}' to '${details.to}'`, details);
+	}
+};
+var DuplicateCampaignError = class extends CrmError {
+	constructor(name) {
+		super("DUPLICATE_CAMPAIGN", `A campaign named '${name}' already exists`, { name });
+	}
+};
+var InvalidSubscriptionTransitionError = class extends CrmError {
+	constructor(details) {
+		super("INVALID_SUBSCRIPTION_TRANSITION", `Subscription ${details.subscriptionId} cannot move from '${details.from}' to '${details.to}'`, details);
+	}
+};
+var DuplicateSubscriptionError = class extends CrmError {
+	constructor(details) {
+		super("DUPLICATE_SUBSCRIPTION", `Contact '${details.contactId}' already has a live subscription on campaign '${details.campaignId}'`, details);
+	}
+};
+var InvalidConfirmationTokenError = class extends CrmError {
+	constructor() {
+		super("INVALID_CONFIRMATION_TOKEN", "No subscription matches the supplied confirmation token, or it has already been used");
+	}
+};
+var InvalidUnsubscribeTokenError = class extends CrmError {
+	constructor() {
+		super("INVALID_UNSUBSCRIBE_TOKEN", "No subscription matches the supplied unsubscribe token");
+	}
+};
+//#endregion
 //#region src/models/tenant-field.ts
 /**
 * Per PACKAGE_RULES §9.2: never hardcode the tenant column's Mongoose
@@ -272,6 +365,9 @@ function buildLeadSchema(config) {
 	schema.index({
 		organizationId: 1,
 		email: 1
+	}, {
+		unique: true,
+		partialFilterExpression: { email: { $type: "string" } }
 	});
 	schema.index({
 		organizationId: 1,
@@ -495,6 +591,26 @@ const contactInfoSchema$1 = new Schema({
 		type: String,
 		trim: true,
 		maxlength: 50
+	},
+	whatsapp: {
+		type: String,
+		trim: true,
+		maxlength: 50
+	},
+	telegram: {
+		type: String,
+		trim: true,
+		maxlength: 100
+	},
+	linkedin: {
+		type: String,
+		trim: true,
+		maxlength: 255
+	},
+	instagram: {
+		type: String,
+		trim: true,
+		maxlength: 100
 	}
 }, { _id: false });
 function buildContactSchema(config) {
@@ -734,6 +850,10 @@ function buildCampaignSchema(config) {
 		},
 		metadata: { type: Schema.Types.Mixed }
 	}, { timestamps: true });
+	schema.index({
+		organizationId: 1,
+		name: 1
+	}, { unique: true });
 	schema.index({
 		organizationId: 1,
 		status: 1
@@ -799,8 +919,14 @@ function canTransitionSubscription(from, to) {
 //#endregion
 //#region src/models/subscription.schema.ts
 /**
-* Subscription — a Contact's opt-in to a Campaign. Double-opt-in tokens,
-* unsubscribe token, compliance audit fields.
+* EmailSubscription — a Contact's opt-in to a Campaign. Double-opt-in
+* tokens, unsubscribe token, compliance audit fields.
+*
+* Registered as Mongoose model `EmailSubscription` (collection
+* `email_subscriptions`) so it doesn't collide with `@classytic/revenue`'s
+* billing-side `Subscription` model when both packages register on the
+* same connection. TypeScript class + file names retain `Subscription` for
+* source-level continuity — only the Mongo identity changed in v0.4.0.
 */
 const statusEntrySchema = new Schema({
 	status: {
@@ -881,7 +1007,10 @@ function buildSubscriptionSchema(config) {
 		},
 		complainedAt: { type: Date },
 		metadata: { type: Schema.Types.Mixed }
-	}, { timestamps: true });
+	}, {
+		timestamps: true,
+		collection: "email_subscriptions"
+	});
 	schema.index({
 		organizationId: 1,
 		campaignId: 1,
@@ -891,6 +1020,9 @@ function buildSubscriptionSchema(config) {
 		organizationId: 1,
 		contactId: 1,
 		campaignId: 1
+	}, {
+		unique: true,
+		partialFilterExpression: { status: { $in: ["pending", "confirmed"] } }
 	});
 	schema.index({
 		organizationId: 1,
@@ -900,7 +1032,8 @@ function buildSubscriptionSchema(config) {
 }
 function createSubscriptionModel(connection, config) {
 	if (connection.models.Subscription) connection.deleteModel("Subscription");
-	return connection.model("Subscription", buildSubscriptionSchema(config));
+	if (connection.models.EmailSubscription) connection.deleteModel("EmailSubscription");
+	return connection.model("EmailSubscription", buildSubscriptionSchema(config));
 }
 //#endregion
 //#region src/enums/activity.ts
@@ -1255,110 +1388,270 @@ function createEmailEventModel(connection, config) {
 	return connection.model("EmailEvent", buildEmailEventSchema(config));
 }
 //#endregion
-//#region src/models/create-models.ts
-function createCrmModels(connection, config) {
-	return Object.freeze({
-		Pipeline: createPipelineModel(connection, config),
-		Lead: createLeadModel(connection, config),
-		Opportunity: createOpportunityModel(connection, config),
-		Contact: createContactModel(connection, config),
-		Account: createAccountModel(connection, config),
-		Campaign: createCampaignModel(connection, config),
-		Subscription: createSubscriptionModel(connection, config),
-		Activity: createActivityModel(connection, config),
-		Note: createNoteModel(connection, config),
-		LossReason: createLossReasonModel(connection, config),
-		EmailEvent: createEmailEventModel(connection, config)
+//#region src/enums/conversation.ts
+/**
+* Conversation / Message vocabulary.
+*
+* Conversations unify a contact's (or pre-conversion lead's) message
+* thread across channels (WhatsApp / Telegram / Email / IG-DM / SMS).
+* The host's webhook adapters write to this surface — the CRM does not
+* dial outward.
+*/
+const CONVERSATION_CHANNELS = [
+	"whatsapp",
+	"telegram",
+	"email",
+	"instagram_dm",
+	"sms",
+	"web_chat"
+];
+const CONVERSATION_STATUSES = [
+	"open",
+	"snoozed",
+	"resolved"
+];
+/** Conversations attach to either a Contact or a (yet-unconverted) Lead. */
+const CONVERSATION_PARTICIPANT_KINDS = ["contact", "lead"];
+const MESSAGE_DIRECTIONS = ["inbound", "outbound"];
+const MESSAGE_DELIVERY_STATUSES = [
+	"queued",
+	"sent",
+	"delivered",
+	"read",
+	"failed"
+];
+//#endregion
+//#region src/models/conversation.schema.ts
+/**
+* Conversation — a multi-channel message thread bound to a Contact or
+* (pre-conversion) Lead. One row per (channel, participant) pair.
+*
+* The CRM stores the thread; channel adapters at the host (WhatsApp Cloud
+* API, Telegram Bot, IMAP, etc.) write inbound `Message`s and emit
+* `outbound` requests via the host's bridge — this package never reaches
+* out to a transport itself (PACKAGE_RULES §11).
+*/
+function buildConversationSchema(config) {
+	const schema = new Schema({
+		organizationId: tenantFieldDef(config),
+		channel: {
+			type: String,
+			enum: CONVERSATION_CHANNELS,
+			required: true,
+			index: true
+		},
+		participantKind: {
+			type: String,
+			enum: CONVERSATION_PARTICIPANT_KINDS,
+			required: true
+		},
+		participantId: {
+			type: Schema.Types.ObjectId,
+			required: true,
+			index: true
+		},
+		channelUserId: {
+			type: String,
+			trim: true,
+			maxlength: 255
+		},
+		status: {
+			type: String,
+			enum: CONVERSATION_STATUSES,
+			default: "open",
+			index: true
+		},
+		lastMessageAt: {
+			type: Date,
+			index: true
+		},
+		unreadCount: {
+			type: Number,
+			default: 0,
+			min: 0
+		},
+		assigneeId: {
+			type: String,
+			index: true
+		},
+		metadata: { type: Schema.Types.Mixed }
+	}, { timestamps: true });
+	schema.index({
+		organizationId: 1,
+		participantKind: 1,
+		participantId: 1
+	});
+	schema.index({
+		organizationId: 1,
+		status: 1,
+		lastMessageAt: -1
+	});
+	schema.index({
+		organizationId: 1,
+		assigneeId: 1,
+		status: 1
+	});
+	schema.index({
+		organizationId: 1,
+		channel: 1,
+		channelUserId: 1
 	});
+	return schema;
+}
+function createConversationModel(connection, config) {
+	if (connection.models.Conversation) connection.deleteModel("Conversation");
+	return connection.model("Conversation", buildConversationSchema(config));
 }
 //#endregion
-//#region src/core/errors.ts
+//#region src/models/message.schema.ts
 /**
-* CRM error vocabulary. Hosts catch `CrmError` at API edges.
+* Message — one event inside a Conversation.
+*
+* Channel-agnostic: `body` is plain text + optional attachments[].
+* Channel-specific quirks (WhatsApp template params, IMAP headers,
+* Telegram entities) live under `metadata`.
+*
+* `externalMessageId` is the dedup key webhooks check against before
+* appending — at-least-once delivery is the rule, not the exception.
 */
-var CrmError = class extends Error {
-	code;
-	details;
-	constructor(code, message, details) {
-		super(message);
-		this.name = "CrmError";
-		this.code = code;
-		if (details !== void 0) this.details = details;
-	}
-};
-var NotFoundError = class extends CrmError {
-	constructor(kind, id) {
-		super(`${kind.toUpperCase()}_NOT_FOUND`, `${kind} '${id}' not found`, {
-			kind,
-			id
-		});
-	}
-};
-var InvalidLeadTransitionError = class extends CrmError {
-	constructor(details) {
-		super("INVALID_LEAD_TRANSITION", `Lead ${details.leadId} cannot move from '${details.from}' to '${details.to}'`, details);
-	}
-};
-var InvalidOpportunityTransitionError = class extends CrmError {
-	constructor(details) {
-		super("INVALID_OPPORTUNITY_TRANSITION", `Opportunity ${details.opportunityId} cannot move from '${details.from}' to '${details.to}'`, details);
-	}
-};
-var InvalidActivityTransitionError = class extends CrmError {
-	constructor(details) {
-		super("INVALID_ACTIVITY_TRANSITION", `Activity ${details.activityId} cannot move from '${details.from}' to '${details.to}'`, details);
-	}
-};
-var StageNotInPipelineError = class extends CrmError {
-	constructor(details) {
-		super("STAGE_NOT_IN_PIPELINE", `Stage '${details.stageId}' is not defined on pipeline '${details.pipelineId}'`, details);
-	}
-};
-var LeadAlreadyConvertedError = class extends CrmError {
-	constructor(leadId) {
-		super("LEAD_ALREADY_CONVERTED", `Lead '${leadId}' is already converted`, { leadId });
-	}
-};
-var DuplicateLeadError = class extends CrmError {
-	constructor(details) {
-		super("DUPLICATE_LEAD", `A lead with this email / phone already exists`, details);
-	}
-};
-var EmptyPipelineError = class extends CrmError {
-	constructor(pipelineId) {
-		super("EMPTY_PIPELINE", `Pipeline '${pipelineId}' has no stages`, { pipelineId });
-	}
-};
-var InvalidCampaignTransitionError = class extends CrmError {
-	constructor(details) {
-		super("INVALID_CAMPAIGN_TRANSITION", `Campaign ${details.campaignId} cannot move from '${details.from}' to '${details.to}'`, details);
+const attachmentSchema = new Schema({
+	type: {
+		type: String,
+		required: true,
+		maxlength: 50
+	},
+	url: {
+		type: String,
+		required: true,
+		maxlength: 2048
+	},
+	name: {
+		type: String,
+		maxlength: 255
+	},
+	size: {
+		type: Number,
+		min: 0
+	},
+	mimeType: {
+		type: String,
+		maxlength: 150
 	}
-};
-var DuplicateCampaignError = class extends CrmError {
-	constructor(name) {
-		super("DUPLICATE_CAMPAIGN", `A campaign named '${name}' already exists`, { name });
-	}
-};
-var InvalidSubscriptionTransitionError = class extends CrmError {
-	constructor(details) {
-		super("INVALID_SUBSCRIPTION_TRANSITION", `Subscription ${details.subscriptionId} cannot move from '${details.from}' to '${details.to}'`, details);
-	}
-};
-var DuplicateSubscriptionError = class extends CrmError {
-	constructor(details) {
-		super("DUPLICATE_SUBSCRIPTION", `Contact '${details.contactId}' already has a live subscription on campaign '${details.campaignId}'`, details);
-	}
-};
-var InvalidConfirmationTokenError = class extends CrmError {
-	constructor() {
-		super("INVALID_CONFIRMATION_TOKEN", "No subscription matches the supplied confirmation token, or it has already been used");
-	}
-};
-var InvalidUnsubscribeTokenError = class extends CrmError {
-	constructor() {
-		super("INVALID_UNSUBSCRIBE_TOKEN", "No subscription matches the supplied unsubscribe token");
-	}
-};
+}, { _id: false });
+function buildMessageSchema(config) {
+	const schema = new Schema({
+		organizationId: tenantFieldDef(config),
+		conversationId: {
+			type: Schema.Types.ObjectId,
+			ref: "Conversation",
+			required: true,
+			index: true
+		},
+		direction: {
+			type: String,
+			enum: MESSAGE_DIRECTIONS,
+			required: true
+		},
+		body: {
+			type: String,
+			default: "",
+			maxlength: 16384
+		},
+		attachments: {
+			type: [attachmentSchema],
+			default: []
+		},
+		externalMessageId: {
+			type: String,
+			trim: true,
+			maxlength: 255
+		},
+		status: {
+			type: String,
+			enum: MESSAGE_DELIVERY_STATUSES,
+			default: "sent"
+		},
+		senderRef: {
+			type: String,
+			trim: true,
+			maxlength: 255
+		},
+		recipientRef: {
+			type: String,
+			trim: true,
+			maxlength: 255
+		},
+		sentAt: { type: Date },
+		metadata: { type: Schema.Types.Mixed }
+	}, { timestamps: true });
+	schema.index({
+		organizationId: 1,
+		conversationId: 1,
+		createdAt: -1
+	});
+	schema.index({
+		organizationId: 1,
+		externalMessageId: 1
+	}, {
+		unique: true,
+		partialFilterExpression: { externalMessageId: { $type: "string" } }
+	});
+	schema.index({ sentAt: 1 }, {
+		expireAfterSeconds: 365 * 24 * 60 * 60,
+		sparse: true,
+		name: "sentAt_ttl"
+	});
+	return schema;
+}
+function createMessageModel(connection, config) {
+	if (connection.models.Message) connection.deleteModel("Message");
+	return connection.model("Message", buildMessageSchema(config));
+}
+//#endregion
+//#region src/models/create-models.ts
+/** Mongoose model names this package registers — drives the §21 collision check. */
+const CRM_MODEL_NAMES = [
+	"Pipeline",
+	"Lead",
+	"Opportunity",
+	"Contact",
+	"Account",
+	"Campaign",
+	"EmailSubscription",
+	"Activity",
+	"Note",
+	"LossReason",
+	"EmailEvent",
+	"Conversation",
+	"Message"
+];
+function createCrmModels(connection, config) {
+	const forceRecreate = config.forceRecreate ?? false;
+	const autoIndex = config.autoIndex ?? true;
+	const namesToCheck = [...CRM_MODEL_NAMES, "Subscription"];
+	if (forceRecreate) {
+		for (const name of namesToCheck) if (connection.models[name]) connection.deleteModel(name);
+	} else for (const name of CRM_MODEL_NAMES) if (connection.models[name]) throw new CrmModelCollisionError(name);
+	const register = (name, schema) => {
+		schema.set("autoIndex", autoIndex);
+		return connection.model(name, schema);
+	};
+	return Object.freeze({
+		Pipeline: register("Pipeline", buildPipelineSchema(config)),
+		Lead: register("Lead", buildLeadSchema(config)),
+		Opportunity: register("Opportunity", buildOpportunitySchema(config)),
+		Contact: register("Contact", buildContactSchema(config)),
+		Account: register("Account", buildAccountSchema(config)),
+		Campaign: register("Campaign", buildCampaignSchema(config)),
+		Subscription: register("EmailSubscription", buildSubscriptionSchema(config)),
+		Activity: register("Activity", buildActivitySchema(config)),
+		Note: register("Note", buildNoteSchema(config)),
+		LossReason: register("LossReason", buildLossReasonSchema(config)),
+		EmailEvent: register("EmailEvent", buildEmailEventSchema(config)),
+		Conversation: register("Conversation", buildConversationSchema(config)),
+		Message: register("Message", buildMessageSchema(config))
+	});
+}
 //#endregion
 //#region src/events/event-constants.ts
 /** PACKAGE_RULES rule 12: `package:resource.verb`. */
@@ -1399,7 +1692,26 @@ const CRM_EVENTS = {
 	EMAIL_EVENT_CLICKED: "crm:email_event.clicked",
 	EMAIL_EVENT_BOUNCED: "crm:email_event.bounced",
 	EMAIL_EVENT_COMPLAINED: "crm:email_event.complained",
-	EMAIL_EVENT_UNSUBSCRIBED: "crm:email_event.unsubscribed"
+	EMAIL_EVENT_UNSUBSCRIBED: "crm:email_event.unsubscribed",
+	LEAD_ENRICHED: "crm:lead.enriched",
+	LEAD_ASSIGNED: "crm:lead.assigned",
+	CONTACT_ENRICHED: "crm:contact.enriched",
+	CONTACT_ASSIGNED: "crm:contact.assigned",
+	CONTACT_MERGED: "crm:contact.merged",
+	ACCOUNT_ENRICHED: "crm:account.enriched",
+	ACCOUNT_ASSIGNED: "crm:account.assigned",
+	ACCOUNT_MERGED: "crm:account.merged",
+	OPPORTUNITY_ASSIGNED: "crm:opportunity.assigned",
+	OPPORTUNITY_AMOUNT_CHANGED: "crm:opportunity.amount_changed",
+	OPPORTUNITY_EXTENDED: "crm:opportunity.extended",
+	ACTIVITY_RESCHEDULED: "crm:activity.rescheduled",
+	ACTIVITY_OUTCOME_RECORDED: "crm:activity.outcome_recorded",
+	CONVERSATION_CREATED: "crm:conversation.created",
+	CONVERSATION_ASSIGNED: "crm:conversation.assigned",
+	CONVERSATION_RESOLVED: "crm:conversation.resolved",
+	CONVERSATION_REOPENED: "crm:conversation.reopened",
+	MESSAGE_RECEIVED: "crm:message.received",
+	MESSAGE_SENT: "crm:message.sent"
 };
 //#endregion
 //#region src/events/helpers.ts
@@ -1582,7 +1894,6 @@ var LeadRepository = class extends Repository {
 		const computedFullName = input.fullName ?? ([input.firstName, input.lastName].filter(Boolean).join(" ").trim() || input.email || input.phone);
 		const draft = {
 			...input,
-			fullName: computedFullName,
 			status: input.status ?? "new",
 			score: 0,
 			statusHistory: [{
@@ -1590,7 +1901,14 @@ var LeadRepository = class extends Repository {
 				occurredAt: now
 			}]
 		};
-		const created = await this.create(draft, ctx);
+		if (computedFullName !== void 0) draft.fullName = computedFullName;
+		let created;
+		try {
+			created = await this.create(draft, ctx);
+		} catch (err) {
+			if (this.rejectDuplicates && input.email && isDuplicateKeyError(err)) throw new DuplicateLeadError({ email: input.email });
+			throw err;
+		}
 		const score = this.scorer(created);
 		let result = created;
 		if (score !== 0) {
@@ -1629,6 +1947,50 @@ var LeadRepository = class extends Repository {
 		return this._transition(id, "nurturing", extras, ctx);
 	}
 	/**
+	* Merge enrichment payload (3rd-party provider response or manual
+	* patch) into the lead doc, then re-score. Emits `crm:lead.enriched`
+	* with the field set written so subscribers can fan out (e.g. push a
+	* `recompute_segment` job) without re-reading the doc.
+	*
+	* The `provider` tag flows into the event for attribution; the package
+	* is provider-agnostic so the actual enrichment call lives at the host.
+	*/
+	async enrich(id, patch, extras = {}, ctx) {
+		if (!await this.getById(id, ctx)) throw new NotFoundError("Lead", id);
+		if (!await this.update(id, patch, ctx)) throw new NotFoundError("Lead", id);
+		const fields = Object.keys(patch);
+		await this.events.publish(createEvent(CRM_EVENTS.LEAD_ENRICHED, {
+			leadId: id,
+			fields,
+			...extras.provider !== void 0 ? { provider: extras.provider } : {}
+		}, ctx));
+		return this.recomputeScore(id, ctx);
+	}
+	/**
+	* Assign / re-assign the lead's owner. Emits `crm:lead.assigned` with
+	* the previous owner so audit consumers can compute hand-off chains.
+	*/
+	async assign(id, ownerId, ctx) {
+		const before = await this.findOneAndUpdate({
+			_id: id,
+			ownerId: { $ne: ownerId }
+		}, { $set: { ownerId } }, {
+			...ctx,
+			returnDocument: "before"
+		});
+		if (!before) {
+			const current = await this.getById(id, ctx);
+			if (!current) throw new NotFoundError("Lead", id);
+			return current;
+		}
+		await this.events.publish(createEvent(CRM_EVENTS.LEAD_ASSIGNED, {
+			leadId: id,
+			ownerId,
+			...before.ownerId !== void 0 ? { previousOwnerId: before.ownerId } : {}
+		}, ctx));
+		return await this.getById(id, ctx) ?? before;
+	}
+	/**
 	* Recompute + persist the lead's score. Called from `createLead`
 	* automatically; hosts also call this after enrichment writes.
 	*/
@@ -1676,6 +2038,29 @@ var LeadRepository = class extends Repository {
 		}, ctx));
 		return updated;
 	}
+	/**
+	* Count leads created on or after `since`. Used by dashboard KPI tiles.
+	* Goes through the inherited tenant-scoped `count()` — the plugin
+	* injects `organizationId` (never a manual `if (ctx)` filter, which
+	* silently reads ALL tenants when ctx is absent).
+	*/
+	async countCreatedSince(since, ctx) {
+		return this.count({ createdAt: { $gte: since } }, ctx);
+	}
+	/** Latest `limit` leads — lightweight projection for the activity feed. */
+	async findRecentForFeed(limit, ctx) {
+		return this.findAll({}, {
+			...ctx,
+			sort: { updatedAt: -1 },
+			limit,
+			select: {
+				_id: 1,
+				fullName: 1,
+				status: 1,
+				updatedAt: 1
+			}
+		});
+	}
 };
 //#endregion
 //#region src/repositories/opportunity.repository.ts
@@ -1799,6 +2184,83 @@ var OpportunityRepository = class extends Repository {
 		}, ctx));
 		return updated;
 	}
+	/**
+	* Re-assign opportunity owner. Mutates `ownerId` only; no status
+	* transition. Emits `crm:opportunity.assigned` with the previous owner.
+	*/
+	async assign(id, ownerId, ctx) {
+		const before = await this.findOneAndUpdate({
+			_id: id,
+			ownerId: { $ne: ownerId }
+		}, { $set: { ownerId } }, {
+			...ctx,
+			returnDocument: "before"
+		});
+		if (!before) {
+			const current = await this.getById(id, ctx);
+			if (!current) throw new NotFoundError("Opportunity", id);
+			return current;
+		}
+		await this.events.publish(createEvent(CRM_EVENTS.OPPORTUNITY_ASSIGNED, {
+			opportunityId: id,
+			ownerId,
+			...before.ownerId !== void 0 ? { previousOwnerId: before.ownerId } : {}
+		}, ctx));
+		return await this.getById(id, ctx) ?? before;
+	}
+	/**
+	* Adjust the deal amount on an open opportunity. Rejected after
+	* win/lose/abandon — closed-deal amounts are immutable history.
+	* Emits `crm:opportunity.amount_changed` with the delta so forecast
+	* subscribers can re-bucket.
+	*/
+	async updateAmount(id, amount, extras = {}, ctx) {
+		const existing = await this.getById(id, ctx);
+		if (!existing) throw new NotFoundError("Opportunity", id);
+		if (existing.status !== "open") throw new InvalidOpportunityTransitionError({
+			from: existing.status,
+			to: existing.status,
+			opportunityId: id
+		});
+		if (amount === existing.amount) return existing;
+		const updated = await this.update(id, { amount }, ctx);
+		if (!updated) throw new NotFoundError("Opportunity", id);
+		await this.events.publish(createEvent(CRM_EVENTS.OPPORTUNITY_AMOUNT_CHANGED, {
+			opportunityId: id,
+			amount,
+			...existing.amount !== void 0 ? { previousAmount: existing.amount } : {},
+			...extras.reason !== void 0 ? { reason: extras.reason } : {},
+			...extras.by !== void 0 ? { by: extras.by } : {}
+		}, ctx));
+		return updated;
+	}
+	/**
+	* Push `expectedCloseAt` further out. Only valid on open opps —
+	* extending a closed deal is meaningless. The new date must be later
+	* than the current one; pulling the date in is silently accepted
+	* (no event is meaningful there).
+	*/
+	async extendCloseDate(id, newDate, extras = {}, ctx) {
+		const existing = await this.getById(id, ctx);
+		if (!existing) throw new NotFoundError("Opportunity", id);
+		if (existing.status !== "open") throw new InvalidOpportunityTransitionError({
+			from: existing.status,
+			to: existing.status,
+			opportunityId: id
+		});
+		const previous = existing.expectedCloseAt;
+		if (previous && newDate <= previous) return existing;
+		const updated = await this.update(id, { expectedCloseAt: newDate }, ctx);
+		if (!updated) throw new NotFoundError("Opportunity", id);
+		await this.events.publish(createEvent(CRM_EVENTS.OPPORTUNITY_EXTENDED, {
+			opportunityId: id,
+			expectedCloseAt: newDate.toISOString(),
+			...previous ? { previousExpectedCloseAt: previous.toISOString() } : {},
+			...extras.reason !== void 0 ? { reason: extras.reason } : {},
+			...extras.by !== void 0 ? { by: extras.by } : {}
+		}, ctx));
+		return updated;
+	}
 	async abandon(id, by, note, ctx) {
 		const updated = await this._closeStatus(id, "abandoned", {
 			closedAt: /* @__PURE__ */ new Date(),
@@ -1837,6 +2299,58 @@ var OpportunityRepository = class extends Repository {
 		});
 		return updated;
 	}
+	/** Count opportunities with status `open`. Used by dashboard KPI tiles. */
+	async countOpen(ctx) {
+		return this.count({ status: "open" }, ctx);
+	}
+	/**
+	* Sum `amount` on won opportunities updated within `since`.
+	* Goes through the tenant-scoped `findAll()` — the multiTenant plugin
+	* injects `organizationId`, so a missing ctx can't leak other tenants'
+	* revenue (a manual `if (ctx)` filter would).
+	*/
+	async sumWonSince(since, ctx) {
+		const rows = await this.findAll({
+			status: "won",
+			updatedAt: { $gte: since }
+		}, {
+			...ctx,
+			select: {
+				amount: 1,
+				currency: 1
+			}
+		});
+		if (rows.length === 0) return null;
+		const byCurrency = /* @__PURE__ */ new Map();
+		for (const r of rows) {
+			const cur = r.currency ?? "UNKNOWN";
+			byCurrency.set(cur, (byCurrency.get(cur) ?? 0) + (r.amount ?? 0));
+		}
+		let topCurrency = "";
+		let topTotal = -Infinity;
+		for (const [cur, total] of byCurrency) if (total > topTotal) {
+			topTotal = total;
+			topCurrency = cur;
+		}
+		return {
+			total: topTotal,
+			currency: topCurrency
+		};
+	}
+	/** Latest `limit` opportunities — lightweight projection for the activity feed. */
+	async findRecentForFeed(limit, ctx) {
+		return this.findAll({}, {
+			...ctx,
+			sort: { updatedAt: -1 },
+			limit,
+			select: {
+				_id: 1,
+				name: 1,
+				status: 1,
+				updatedAt: 1
+			}
+		});
+	}
 };
 //#endregion
 //#region src/repositories/contact.repository.ts
@@ -1858,7 +2372,108 @@ var ContactRepository = class extends Repository {
 		}, ctx));
 		return created;
 	}
+	/**
+	* Merge enrichment payload into the contact. The `patch` is applied
+	* verbatim; deep-merge of `contact.*` channels is the caller's job
+	* (they own the provider response shape).
+	*/
+	async enrich(id, patch, extras = {}, ctx) {
+		if (!await this.getById(id, ctx)) throw new NotFoundError("Contact", id);
+		const updated = await this.update(id, patch, ctx);
+		if (!updated) throw new NotFoundError("Contact", id);
+		await this.events.publish(createEvent(CRM_EVENTS.CONTACT_ENRICHED, {
+			contactId: id,
+			fields: Object.keys(patch),
+			...extras.provider !== void 0 ? { provider: extras.provider } : {}
+		}, ctx));
+		return updated;
+	}
+	/** Set / re-assign the contact's owner. Atomic; no-op when unchanged. */
+	async assign(id, ownerId, ctx) {
+		const before = await this.findOneAndUpdate({
+			_id: id,
+			ownerId: { $ne: ownerId }
+		}, { $set: { ownerId } }, {
+			...ctx,
+			returnDocument: "before"
+		});
+		if (!before) {
+			const current = await this.getById(id, ctx);
+			if (!current) throw new NotFoundError("Contact", id);
+			return current;
+		}
+		await this.events.publish(createEvent(CRM_EVENTS.CONTACT_ASSIGNED, {
+			contactId: id,
+			ownerId,
+			...before.ownerId !== void 0 ? { previousOwnerId: before.ownerId } : {}
+		}, ctx));
+		return await this.getById(id, ctx) ?? before;
+	}
+	/**
+	* Merge two contacts. Secondary's non-conflicting fields are folded
+	* into primary, tags are unioned, then secondary is deleted.
+	*
+	* Hosts wanting transactional safety can pass `ctx.session` —
+	* mongokit threads it through `update` + `delete`.
+	*
+	* Re-pointing related Activities / Notes / Opportunities is the host's
+	* job (they own those relationships) — subscribe to
+	* `crm:contact.merged` and rewrite `subjectId` / `primaryContactId`
+	* from there.
+	*/
+	async merge(input, ctx) {
+		const { primaryId, secondaryId } = input;
+		if (primaryId === secondaryId) throw new Error("[crm] cannot merge a contact with itself");
+		const strategy = input.strategy ?? "preferPrimary";
+		const [primary, secondary] = await Promise.all([this.getById(primaryId, ctx), this.getById(secondaryId, ctx)]);
+		if (!primary) throw new NotFoundError("Contact", primaryId);
+		if (!secondary) throw new NotFoundError("Contact", secondaryId);
+		const winner = strategy === "preferPrimary" ? primary : secondary;
+		const loser = strategy === "preferPrimary" ? secondary : primary;
+		const winnerContact = plainOf(winner.contact);
+		const loserContact = plainOf(loser.contact);
+		const winnerName = plainOf(winner.name);
+		const loserName = plainOf(loser.name);
+		const mergedContactInfo = {
+			...loserContact,
+			...stripEmpty(winnerContact)
+		};
+		const patch = {
+			name: {
+				...loserName,
+				...stripEmpty(winnerName)
+			},
+			contact: mergedContactInfo,
+			tags: Array.from(new Set([...primary.tags ?? [], ...secondary.tags ?? []])),
+			...winner.jobTitle !== void 0 ? { jobTitle: winner.jobTitle } : loser.jobTitle !== void 0 ? { jobTitle: loser.jobTitle } : {},
+			...winner.accountId !== void 0 ? { accountId: winner.accountId } : loser.accountId !== void 0 ? { accountId: loser.accountId } : {},
+			...winner.ownerId !== void 0 ? { ownerId: winner.ownerId } : loser.ownerId !== void 0 ? { ownerId: loser.ownerId } : {}
+		};
+		const updated = await this.update(primaryId, patch, ctx);
+		if (!updated) throw new NotFoundError("Contact", primaryId);
+		await this.delete(secondaryId, ctx);
+		await this.events.publish(createEvent(CRM_EVENTS.CONTACT_MERGED, {
+			primaryId,
+			secondaryId,
+			strategy
+		}, ctx));
+		return updated;
+	}
 };
+function stripEmpty(obj) {
+	const out = {};
+	for (const [k, v] of Object.entries(obj)) if (v !== void 0 && v !== null && v !== "") out[k] = v;
+	return out;
+}
+/**
+* Convert a Mongoose subdocument (or plain object) into a plain JS object.
+* Spreading a Mongoose subdoc directly leaks `$__parent` / `_doc` etc.
+*/
+function plainOf(value) {
+	if (value === null || value === void 0) return {};
+	if (typeof value.toObject === "function") return value.toObject();
+	return value;
+}
 //#endregion
 //#region src/repositories/account.repository.ts
 var AccountRepository = class extends Repository {
@@ -1875,7 +2490,72 @@ var AccountRepository = class extends Repository {
 		}, ctx));
 		return created;
 	}
+	async enrich(id, patch, extras = {}, ctx) {
+		if (!await this.getById(id, ctx)) throw new NotFoundError("Account", id);
+		const updated = await this.update(id, patch, ctx);
+		if (!updated) throw new NotFoundError("Account", id);
+		await this.events.publish(createEvent(CRM_EVENTS.ACCOUNT_ENRICHED, {
+			accountId: id,
+			fields: Object.keys(patch),
+			...extras.provider !== void 0 ? { provider: extras.provider } : {}
+		}, ctx));
+		return updated;
+	}
+	async assign(id, ownerId, ctx) {
+		const before = await this.findOneAndUpdate({
+			_id: id,
+			ownerId: { $ne: ownerId }
+		}, { $set: { ownerId } }, {
+			...ctx,
+			returnDocument: "before"
+		});
+		if (!before) {
+			const current = await this.getById(id, ctx);
+			if (!current) throw new NotFoundError("Account", id);
+			return current;
+		}
+		await this.events.publish(createEvent(CRM_EVENTS.ACCOUNT_ASSIGNED, {
+			accountId: id,
+			ownerId,
+			...before.ownerId !== void 0 ? { previousOwnerId: before.ownerId } : {}
+		}, ctx));
+		return await this.getById(id, ctx) ?? before;
+	}
+	async merge(input, ctx) {
+		const { primaryId, secondaryId } = input;
+		if (primaryId === secondaryId) throw new Error("[crm] cannot merge an account with itself");
+		const strategy = input.strategy ?? "preferPrimary";
+		const [primary, secondary] = await Promise.all([this.getById(primaryId, ctx), this.getById(secondaryId, ctx)]);
+		if (!primary) throw new NotFoundError("Account", primaryId);
+		if (!secondary) throw new NotFoundError("Account", secondaryId);
+		const winner = strategy === "preferPrimary" ? primary : secondary;
+		const loser = strategy === "preferPrimary" ? secondary : primary;
+		const mergedTags = Array.from(new Set([...primary.tags ?? [], ...secondary.tags ?? []]));
+		const patch = {
+			name: winner.name || loser.name,
+			tags: mergedTags,
+			...firstDefined("domain", winner.domain, loser.domain),
+			...firstDefined("industry", winner.industry, loser.industry),
+			...firstDefined("sizeBucket", winner.sizeBucket, loser.sizeBucket),
+			...firstDefined("annualRevenueAmount", winner.annualRevenueAmount, loser.annualRevenueAmount),
+			...firstDefined("ownerId", winner.ownerId, loser.ownerId)
+		};
+		const updated = await this.update(primaryId, patch, ctx);
+		if (!updated) throw new NotFoundError("Account", primaryId);
+		await this.delete(secondaryId, ctx);
+		await this.events.publish(createEvent(CRM_EVENTS.ACCOUNT_MERGED, {
+			primaryId,
+			secondaryId,
+			strategy
+		}, ctx));
+		return updated;
+	}
 };
+function firstDefined(key, a, b) {
+	if (a !== void 0 && a !== null) return { [key]: a };
+	if (b !== void 0 && b !== null) return { [key]: b };
+	return {};
+}
 //#endregion
 //#region src/repositories/campaign.repository.ts
 var CampaignRepository = class extends Repository {
@@ -1900,7 +2580,13 @@ var CampaignRepository = class extends Repository {
 				occurredAt: now
 			}]
 		};
-		const created = await this.create(draft, ctx);
+		let created;
+		try {
+			created = await this.create(draft, ctx);
+		} catch (err) {
+			if (this.rejectDuplicates && input.name && isDuplicateKeyError(err)) throw new DuplicateCampaignError(input.name);
+			throw err;
+		}
 		await this.events.publish(createEvent(CRM_EVENTS.CAMPAIGN_CREATED, {
 			campaignId: String(created._id),
 			name: created.name
@@ -2020,7 +2706,16 @@ var SubscriptionRepository = class extends Repository {
 			...input.consentUserAgent !== void 0 ? { consentUserAgent: input.consentUserAgent } : {},
 			...input.metadata !== void 0 ? { metadata: input.metadata } : {}
 		};
-		const sub = await this.create(draft, ctx);
+		let sub;
+		try {
+			sub = await this.create(draft, ctx);
+		} catch (err) {
+			if (isDuplicateKeyError(err)) throw new DuplicateSubscriptionError({
+				contactId: input.contactId,
+				campaignId: input.campaignId
+			});
+			throw err;
+		}
 		await this.events.publish(createEvent(CRM_EVENTS.SUBSCRIPTION_CREATED, {
 			subscriptionId: String(sub._id),
 			contactId: sub.contactId,
@@ -2164,6 +2859,55 @@ var ActivityRepository = class extends Repository {
 		}, ctx));
 		return updated;
 	}
+	/**
+	* Push an activity's `dueDate`. Allowed on planned / in_progress only;
+	* rescheduling a completed or cancelled activity makes no sense.
+	* Emits `crm:activity.rescheduled` with the previous date for audit.
+	*/
+	async reschedule(id, newDueDate, extras = {}, ctx) {
+		const existing = await this.getById(id, ctx);
+		if (!existing) throw new NotFoundError("Activity", id);
+		if (existing.status !== "planned" && existing.status !== "in_progress") throw new InvalidActivityTransitionError({
+			from: existing.status,
+			to: existing.status,
+			activityId: id
+		});
+		const previous = existing.dueDate;
+		const updated = await this.update(id, { dueDate: newDueDate }, ctx);
+		if (!updated) throw new NotFoundError("Activity", id);
+		await this.events.publish(createEvent(CRM_EVENTS.ACTIVITY_RESCHEDULED, {
+			activityId: id,
+			dueDate: newDueDate.toISOString(),
+			...previous ? { previousDueDate: previous.toISOString() } : {},
+			...extras.reason !== void 0 ? { reason: extras.reason } : {},
+			...extras.by !== void 0 ? { by: extras.by } : {}
+		}, ctx));
+		return updated;
+	}
+	/**
+	* Record the outcome of an activity (call result, email engagement,
+	* meeting confirmation). Stored under `metadata.outcome` so it stays
+	* polymorphic — the shape is the channel's concern, not this package's.
+	*
+	* Does NOT transition status — call `complete()` separately when the
+	* outcome implies completion. This split lets agents log partial
+	* outcomes (e.g. "left voicemail") without forcing terminal state.
+	*/
+	async recordOutcome(id, outcome, ctx) {
+		const existing = await this.getById(id, ctx);
+		if (!existing) throw new NotFoundError("Activity", id);
+		const mergedMetadata = {
+			...existing.metadata ?? {},
+			outcome
+		};
+		const updated = await this.update(id, { metadata: mergedMetadata }, ctx);
+		if (!updated) throw new NotFoundError("Activity", id);
+		await this.events.publish(createEvent(CRM_EVENTS.ACTIVITY_OUTCOME_RECORDED, {
+			activityId: id,
+			outcome
+		}, ctx));
+		return updated;
+	}
 	async _transition(id, target, patch, ctx) {
 		const existing = await this.getById(id, ctx);
 		if (!existing) throw new NotFoundError("Activity", id);
@@ -2181,6 +2925,29 @@ var ActivityRepository = class extends Repository {
 		});
 		return updated;
 	}
+	/** Count `planned` activities with `dueDate` before `asOf`. Dashboard KPI. */
+	async countOverduePlanned(asOf, ctx) {
+		return this.count({
+			status: "planned",
+			dueDate: { $lt: asOf }
+		}, ctx);
+	}
+	/** Latest `limit` activities — lightweight projection for the activity feed. */
+	async findRecentForFeed(limit, ctx) {
+		return this.findAll({}, {
+			...ctx,
+			sort: { updatedAt: -1 },
+			limit,
+			select: {
+				_id: 1,
+				title: 1,
+				status: 1,
+				updatedAt: 1,
+				subjectKind: 1,
+				subjectId: 1
+			}
+		});
+	}
 };
 //#endregion
 //#region src/repositories/note.repository.ts
@@ -2269,6 +3036,161 @@ var EmailEventRepository = class extends Repository {
 	}
 };
 //#endregion
+//#region src/repositories/conversation.repository.ts
+var ConversationRepository = class extends Repository {
+	events;
+	constructor(model, plugins, deps, pagination) {
+		super(model, plugins, pagination);
+		this.events = deps.events;
+	}
+	async openConversation(input, ctx) {
+		const draft = {
+			channel: input.channel,
+			participantKind: input.participantKind,
+			participantId: input.participantId,
+			status: "open",
+			unreadCount: 0,
+			...input.channelUserId !== void 0 ? { channelUserId: input.channelUserId } : {},
+			...input.assigneeId !== void 0 ? { assigneeId: input.assigneeId } : {},
+			...input.metadata !== void 0 ? { metadata: input.metadata } : {}
+		};
+		const created = await this.create(draft, ctx);
+		await this.events.publish(createEvent(CRM_EVENTS.CONVERSATION_CREATED, {
+			conversationId: String(created._id),
+			channel: created.channel,
+			participantKind: created.participantKind,
+			participantId: String(created.participantId)
+		}, ctx));
+		return created;
+	}
+	async assign(id, assigneeId, ctx) {
+		const before = await this.findOneAndUpdate({
+			_id: id,
+			assigneeId: { $ne: assigneeId }
+		}, { $set: { assigneeId } }, {
+			...ctx,
+			returnDocument: "before"
+		});
+		if (!before) {
+			const current = await this.getById(id, ctx);
+			if (!current) throw new NotFoundError("Conversation", id);
+			return current;
+		}
+		await this.events.publish(createEvent(CRM_EVENTS.CONVERSATION_ASSIGNED, {
+			conversationId: id,
+			assigneeId,
+			...before.assigneeId !== void 0 ? { previousAssigneeId: before.assigneeId } : {}
+		}, ctx));
+		return await this.getById(id, ctx) ?? before;
+	}
+	async resolve(id, ctx) {
+		return this._setStatus(id, "resolved", CRM_EVENTS.CONVERSATION_RESOLVED, ctx);
+	}
+	async reopen(id, ctx) {
+		return this._setStatus(id, "open", CRM_EVENTS.CONVERSATION_REOPENED, ctx);
+	}
+	/** Reset unread badge. Pure UI affordance, no event. */
+	async markRead(id, ctx) {
+		const updated = await this.update(id, { unreadCount: 0 }, ctx);
+		if (!updated) throw new NotFoundError("Conversation", id);
+		return updated;
+	}
+	/**
+	* Bump `lastMessageAt` and (for inbound) increment `unreadCount`.
+	* Called by `MessageRepository` when a message is recorded — not part
+	* of the public surface. Returns the conversation for the caller's
+	* follow-up writes.
+	*/
+	async touch(id, args, ctx) {
+		const existing = await this.getById(id, ctx);
+		if (!existing) return null;
+		const patch = { lastMessageAt: args.sentAt };
+		if (args.direction === "inbound") patch.unreadCount = (existing.unreadCount ?? 0) + 1;
+		return await this.update(id, patch, ctx) ?? null;
+	}
+	async _setStatus(id, next, eventType, ctx) {
+		const existing = await this.getById(id, ctx);
+		if (!existing) throw new NotFoundError("Conversation", id);
+		if (existing.status === next) return existing;
+		const updated = await this.update(id, { status: next }, ctx);
+		if (!updated) throw new NotFoundError("Conversation", id);
+		await this.events.publish(createEvent(eventType, {
+			conversationId: id,
+			status: next,
+			previousStatus: existing.status
+		}, ctx));
+		return updated;
+	}
+};
+//#endregion
+//#region src/repositories/message.repository.ts
+var MessageRepository = class extends Repository {
+	events;
+	conversations;
+	constructor(model, plugins, deps, pagination) {
+		super(model, plugins, pagination);
+		this.events = deps.events;
+		this.conversations = deps.conversations;
+	}
+	async recordInbound(input, ctx) {
+		return this._record(input, "inbound", "delivered", CRM_EVENTS.MESSAGE_RECEIVED, ctx);
+	}
+	async recordOutbound(input, ctx) {
+		return this._record(input, "outbound", "sent", CRM_EVENTS.MESSAGE_SENT, ctx);
+	}
+	/** Wire delivery callback (e.g. WhatsApp `status` webhook). */
+	async updateStatus(id, status, ctx) {
+		const existing = await this.getById(id, ctx);
+		if (!existing) throw new NotFoundError("Message", id);
+		if (existing.status === status) return existing;
+		const updated = await this.update(id, { status }, ctx);
+		if (!updated) throw new NotFoundError("Message", id);
+		return updated;
+	}
+	async _record(input, direction, defaultStatus, eventType, ctx) {
+		const sentAt = input.sentAt ?? /* @__PURE__ */ new Date();
+		const draft = {
+			conversationId: input.conversationId,
+			direction,
+			body: input.body,
+			attachments: input.attachments ?? [],
+			status: defaultStatus,
+			sentAt,
+			...input.externalMessageId !== void 0 ? { externalMessageId: input.externalMessageId } : {},
+			...input.senderRef !== void 0 ? { senderRef: input.senderRef } : {},
+			...input.recipientRef !== void 0 ? { recipientRef: input.recipientRef } : {},
+			...input.metadata !== void 0 ? { metadata: input.metadata } : {}
+		};
+		const created = await this.create(draft, ctx);
+		await this.conversations.touch(input.conversationId, {
+			direction,
+			sentAt
+		}, ctx);
+		await this.events.publish(createEvent(eventType, {
+			messageId: String(created._id),
+			conversationId: input.conversationId,
+			direction,
+			...input.externalMessageId !== void 0 ? { externalMessageId: input.externalMessageId } : {}
+		}, ctx));
+		return created;
+	}
+	/** Latest `limit` messages — lightweight projection for the activity feed. */
+	async findRecentForFeed(limit, ctx) {
+		return this.findAll({}, {
+			...ctx,
+			sort: { sentAt: -1 },
+			limit,
+			select: {
+				_id: 1,
+				body: 1,
+				direction: 1,
+				conversationId: 1,
+				sentAt: 1
+			}
+		});
+	}
+};
+//#endregion
 //#region src/repositories/create-repositories.ts
 /**
 * Repository factory — composes the shared mongokit plugin stack and
@@ -2306,6 +3228,11 @@ function createCrmRepositories(models, deps) {
 	const note = new NoteRepository(models.Note, plugins, { events }, pagination);
 	const lossReason = new LossReasonRepository(models.LossReason, plugins, { events }, pagination);
 	const emailEvent = new EmailEventRepository(models.EmailEvent, plugins, { events }, pagination);
+	const conversation = new ConversationRepository(models.Conversation, plugins, { events }, pagination);
+	const message = new MessageRepository(models.Message, plugins, {
+		events,
+		conversations: conversation
+	}, pagination);
 	return Object.freeze({
 		pipeline,
 		lead,
@@ -2317,7 +3244,9 @@ function createCrmRepositories(models, deps) {
 		activity,
 		note,
 		lossReason,
-		emailEvent
+		emailEvent,
+		conversation,
+		message
 	});
 }
 //#endregion
@@ -2358,6 +3287,24 @@ var InProcessCrmBus = class {
 	}
 };
 //#endregion
+//#region src/engine/ensure-ready.ts
+const REQUIRED_CAPABILITIES = [
+	"upsert",
+	"getOrCreate",
+	"duplicateKeyError"
+];
+function assertCrmCapabilities(probe, options = {}) {
+	const caps = probe.capabilities;
+	if (!caps) throw new Error("[crm] backend declares no `capabilities` descriptor (requires @classytic/repo-core 0.6 / mongokit 3.16+).");
+	const missing = REQUIRED_CAPABILITIES.filter((flag) => caps[flag] !== true);
+	if (missing.length > 0) throw new Error(`[crm] backend missing required capabilities: ${missing.join(", ")}. Lead dedup + conversion depend on them.`);
+	if (caps.transactions !== true) {
+		const msg = "[crm] backend does not support transactions — LeadService.convert() cannot run atomically across Account/Contact/Opportunity. Run MongoDB as a replica set, or pass { allowNonTransactional: true } if convert() is never called with a session.";
+		if (options.allowNonTransactional) options.logger?.warn?.(msg);
+		else throw new Error(msg);
+	}
+}
+//#endregion
 //#region src/engine/create-crm.ts
 async function createCrm(config) {
 	if (!config.connection) throw new Error("[crm] CrmConfig.connection is required");
@@ -2365,6 +3312,8 @@ async function createCrm(config) {
 		connection: config.connection,
 		tenantFieldType: config.tenantFieldType ?? "objectId",
 		multiTenant: config.multiTenant ?? true,
+		forceRecreate: config.forceRecreate ?? false,
+		autoIndex: config.autoIndex ?? true,
 		...config.logger !== void 0 ? { logger: config.logger } : {},
 		...config.pagination !== void 0 ? { pagination: config.pagination } : {},
 		plugins: config.plugins ?? []
@@ -2375,11 +3324,18 @@ async function createCrm(config) {
 		events,
 		config: resolved
 	});
+	assertCrmCapabilities(repositories.lead, {
+		...config.allowNonTransactional !== void 0 ? { allowNonTransactional: config.allowNonTransactional } : {},
+		...config.logger?.warn !== void 0 ? { logger: { warn: (m) => config.logger?.warn?.(m) } } : {}
+	});
 	return Object.freeze({
 		models,
 		repositories,
 		events,
 		config: Object.freeze(resolved),
+		async syncIndexes() {
+			await Promise.all(Object.values(models).map((m) => m.syncIndexes()));
+		},
 		async dispose() {
 			await events.close?.();
 		}
@@ -2561,6 +3517,602 @@ function splitLeadName(lead) {
 	};
 }
 //#endregion
+//#region src/events/event-catalog.ts
+/**
+* Zod-source event catalog (PACKAGE_RULES rule 18).
+*
+* One Zod schema per event is the source of truth — runtime validation,
+* static types, and Arc introspection all derive from it. Hosts wire the
+* definitions into arc's `EventRegistry`:
+*
+* ```ts
+* for (const def of crmEventDefinitions) registry.register(def);
+* ```
+*
+* which lights up publish-time validation (`eventPlugin({ registry,
+* validateMode: 'reject' })`), OpenAPI event introspection, and
+* `arc describe` output — with zero arc imports here (the definition shape
+* is structurally identical to arc's `EventDefinitionOutput`).
+*
+* Timestamps in payloads are `z.iso.datetime()` (NEVER `z.coerce.date()`):
+* `z.toJSONSchema()` throws on coerce.date, and events are ISO strings on
+* the wire (rule 25).
+*/
+function defineCrmEvent(input) {
+	const { name, resource, description, version = 1, zodSchema } = input;
+	return {
+		name,
+		version,
+		description,
+		zodSchema,
+		schema: z.toJSONSchema(zodSchema),
+		create(payload, meta) {
+			return createEvent$1(name, payload, {
+				resource,
+				source: "crm",
+				...meta
+			});
+		}
+	};
+}
+const ownerChangeSchema = z.object({
+	ownerId: z.string(),
+	previousOwnerId: z.string().optional()
+});
+const enrichSchema = z.object({
+	fields: z.array(z.string()),
+	provider: z.string().optional()
+});
+const mergeSchema = z.object({
+	primaryId: z.string(),
+	secondaryId: z.string(),
+	strategy: z.enum(["preferPrimary", "preferSecondary"])
+});
+const stageRefSchema = z.object({
+	stageId: z.string(),
+	sequence: z.number()
+});
+const LeadCreated = defineCrmEvent({
+	name: CRM_EVENTS.LEAD_CREATED,
+	resource: "lead",
+	description: "createLead() inserted a scored lead.",
+	zodSchema: z.object({
+		leadId: z.string(),
+		email: z.string().optional(),
+		score: z.number()
+	})
+});
+const LeadStatusChanged = defineCrmEvent({
+	name: CRM_EVENTS.LEAD_STATUS_CHANGED,
+	resource: "lead",
+	description: "A lead lifecycle transition committed (qualify/disqualify/nurture/...).",
+	zodSchema: z.object({
+		leadId: z.string(),
+		from: z.string(),
+		to: z.string()
+	})
+});
+const LeadScored = defineCrmEvent({
+	name: CRM_EVENTS.LEAD_SCORED,
+	resource: "lead",
+	description: "A lead score was (re)computed and persisted.",
+	zodSchema: z.object({
+		leadId: z.string(),
+		score: z.number()
+	})
+});
+const LeadConverted = defineCrmEvent({
+	name: CRM_EVENTS.LEAD_CONVERTED,
+	resource: "lead",
+	description: "convert() spawned Contact (+ Account) + Opportunity and closed the lead.",
+	zodSchema: z.object({
+		leadId: z.string(),
+		contactId: z.string(),
+		accountId: z.string().optional(),
+		opportunityId: z.string()
+	})
+});
+const LeadDisqualified = defineCrmEvent({
+	name: CRM_EVENTS.LEAD_DISQUALIFIED,
+	resource: "lead",
+	description: "disqualify() rejected a lead with a reason.",
+	zodSchema: z.object({
+		leadId: z.string(),
+		reason: z.string()
+	})
+});
+const LeadEnriched = defineCrmEvent({
+	name: CRM_EVENTS.LEAD_ENRICHED,
+	resource: "lead",
+	description: "enrich() merged a provider/manual patch into the lead.",
+	zodSchema: z.object({ leadId: z.string() }).extend(enrichSchema.shape)
+});
+const LeadAssigned = defineCrmEvent({
+	name: CRM_EVENTS.LEAD_ASSIGNED,
+	resource: "lead",
+	description: "assign() (re)assigned the lead owner.",
+	zodSchema: z.object({ leadId: z.string() }).extend(ownerChangeSchema.shape)
+});
+const AccountCreated = defineCrmEvent({
+	name: CRM_EVENTS.ACCOUNT_CREATED,
+	resource: "account",
+	description: "createAccount() inserted an account.",
+	zodSchema: z.object({
+		accountId: z.string(),
+		name: z.string()
+	})
+});
+const AccountUpdated = defineCrmEvent({
+	name: CRM_EVENTS.ACCOUNT_UPDATED,
+	resource: "account",
+	description: "An account record was updated.",
+	zodSchema: z.object({ accountId: z.string() })
+});
+const AccountEnriched = defineCrmEvent({
+	name: CRM_EVENTS.ACCOUNT_ENRICHED,
+	resource: "account",
+	description: "enrich() merged a patch into the account.",
+	zodSchema: z.object({ accountId: z.string() }).extend(enrichSchema.shape)
+});
+const AccountAssigned = defineCrmEvent({
+	name: CRM_EVENTS.ACCOUNT_ASSIGNED,
+	resource: "account",
+	description: "assign() (re)assigned the account owner.",
+	zodSchema: z.object({ accountId: z.string() }).extend(ownerChangeSchema.shape)
+});
+const AccountMerged = defineCrmEvent({
+	name: CRM_EVENTS.ACCOUNT_MERGED,
+	resource: "account",
+	description: "merge() folded a secondary account into the primary; secondary deleted.",
+	zodSchema: mergeSchema
+});
+const ContactCreated = defineCrmEvent({
+	name: CRM_EVENTS.CONTACT_CREATED,
+	resource: "contact",
+	description: "createContact() inserted a contact.",
+	zodSchema: z.object({
+		contactId: z.string(),
+		email: z.string().optional()
+	})
+});
+const ContactUpdated = defineCrmEvent({
+	name: CRM_EVENTS.CONTACT_UPDATED,
+	resource: "contact",
+	description: "A contact record was updated.",
+	zodSchema: z.object({ contactId: z.string() })
+});
+const ContactEnriched = defineCrmEvent({
+	name: CRM_EVENTS.CONTACT_ENRICHED,
+	resource: "contact",
+	description: "enrich() merged a patch into the contact.",
+	zodSchema: z.object({ contactId: z.string() }).extend(enrichSchema.shape)
+});
+const ContactAssigned = defineCrmEvent({
+	name: CRM_EVENTS.CONTACT_ASSIGNED,
+	resource: "contact",
+	description: "assign() (re)assigned the contact owner.",
+	zodSchema: z.object({ contactId: z.string() }).extend(ownerChangeSchema.shape)
+});
+const ContactMerged = defineCrmEvent({
+	name: CRM_EVENTS.CONTACT_MERGED,
+	resource: "contact",
+	description: "merge() folded a secondary contact into the primary; secondary deleted.",
+	zodSchema: mergeSchema
+});
+const OpportunityCreated = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_CREATED,
+	resource: "opportunity",
+	description: "openOpportunity() created a deal in a pipeline stage.",
+	zodSchema: z.object({
+		opportunityId: z.string(),
+		pipelineId: z.string(),
+		stageId: z.string()
+	})
+});
+const OpportunityStageAdvanced = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_STAGE_ADVANCED,
+	resource: "opportunity",
+	description: "moveToStage() moved the deal forward (higher stage sequence).",
+	zodSchema: z.object({
+		opportunityId: z.string(),
+		from: stageRefSchema,
+		to: stageRefSchema
+	})
+});
+const OpportunityStageRegressed = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_STAGE_REGRESSED,
+	resource: "opportunity",
+	description: "moveToStage() moved the deal backward (lower stage sequence).",
+	zodSchema: z.object({
+		opportunityId: z.string(),
+		from: stageRefSchema,
+		to: stageRefSchema
+	})
+});
+const OpportunityWon = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_WON,
+	resource: "opportunity",
+	description: "win() closed the deal as won (terminal).",
+	zodSchema: z.object({
+		opportunityId: z.string(),
+		amount: z.number().optional()
+	})
+});
+const OpportunityLost = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_LOST,
+	resource: "opportunity",
+	description: "lose() closed the deal as lost (terminal).",
+	zodSchema: z.object({
+		opportunityId: z.string(),
+		lostReasonId: z.string().optional()
+	})
+});
+const OpportunityAbandoned = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_ABANDONED,
+	resource: "opportunity",
+	description: "abandon() closed the deal as abandoned (terminal).",
+	zodSchema: z.object({ opportunityId: z.string() })
+});
+const OpportunityAssigned = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_ASSIGNED,
+	resource: "opportunity",
+	description: "assign() (re)assigned the opportunity owner.",
+	zodSchema: z.object({ opportunityId: z.string() }).extend(ownerChangeSchema.shape)
+});
+const OpportunityAmountChanged = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_AMOUNT_CHANGED,
+	resource: "opportunity",
+	description: "updateAmount() changed an open deal value.",
+	zodSchema: z.object({
+		opportunityId: z.string(),
+		amount: z.number(),
+		previousAmount: z.number().optional(),
+		reason: z.string().optional(),
+		by: z.string().optional()
+	})
+});
+const OpportunityExtended = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_EXTENDED,
+	resource: "opportunity",
+	description: "extendCloseDate() pushed expectedCloseAt further out.",
+	zodSchema: z.object({
+		opportunityId: z.string(),
+		expectedCloseAt: z.iso.datetime(),
+		previousExpectedCloseAt: z.iso.datetime().optional(),
+		reason: z.string().optional(),
+		by: z.string().optional()
+	})
+});
+const PipelineCreated = defineCrmEvent({
+	name: CRM_EVENTS.PIPELINE_CREATED,
+	resource: "pipeline",
+	description: "A pipeline was created.",
+	zodSchema: z.object({ pipelineId: z.string() })
+});
+const PipelineArchived = defineCrmEvent({
+	name: CRM_EVENTS.PIPELINE_ARCHIVED,
+	resource: "pipeline",
+	description: "archive() soft-deprecated a pipeline.",
+	zodSchema: z.object({ pipelineId: z.string() })
+});
+const ActivityPlanned = defineCrmEvent({
+	name: CRM_EVENTS.ACTIVITY_PLANNED,
+	resource: "activity",
+	description: "plan() created a planned activity against a subject.",
+	zodSchema: z.object({
+		activityId: z.string(),
+		type: z.string(),
+		subjectKind: z.string(),
+		subjectId: z.string()
+	})
+});
+const ActivityCompleted = defineCrmEvent({
+	name: CRM_EVENTS.ACTIVITY_COMPLETED,
+	resource: "activity",
+	description: "complete() finished an activity.",
+	zodSchema: z.object({
+		activityId: z.string(),
+		completedAt: z.iso.datetime()
+	})
+});
+const ActivityCancelled = defineCrmEvent({
+	name: CRM_EVENTS.ACTIVITY_CANCELLED,
+	resource: "activity",
+	description: "cancel() cancelled an activity.",
+	zodSchema: z.object({
+		activityId: z.string(),
+		reason: z.string().optional()
+	})
+});
+const ActivityRescheduled = defineCrmEvent({
+	name: CRM_EVENTS.ACTIVITY_RESCHEDULED,
+	resource: "activity",
+	description: "reschedule() moved an activity due date.",
+	zodSchema: z.object({
+		activityId: z.string(),
+		dueDate: z.iso.datetime(),
+		previousDueDate: z.iso.datetime().optional(),
+		reason: z.string().optional(),
+		by: z.string().optional()
+	})
+});
+const ActivityOutcomeRecorded = defineCrmEvent({
+	name: CRM_EVENTS.ACTIVITY_OUTCOME_RECORDED,
+	resource: "activity",
+	description: "recordOutcome() logged an activity outcome (no status change).",
+	zodSchema: z.object({
+		activityId: z.string(),
+		outcome: z.record(z.string(), z.unknown())
+	})
+});
+const NoteAdded = defineCrmEvent({
+	name: CRM_EVENTS.NOTE_ADDED,
+	resource: "note",
+	description: "A note was appended to a subject timeline.",
+	zodSchema: z.object({
+		noteId: z.string(),
+		subjectKind: z.string(),
+		subjectId: z.string()
+	})
+});
+const CampaignCreated = defineCrmEvent({
+	name: CRM_EVENTS.CAMPAIGN_CREATED,
+	resource: "campaign",
+	description: "createCampaign() inserted a campaign.",
+	zodSchema: z.object({
+		campaignId: z.string(),
+		name: z.string()
+	})
+});
+const CampaignActivated = defineCrmEvent({
+	name: CRM_EVENTS.CAMPAIGN_ACTIVATED,
+	resource: "campaign",
+	description: "activate() moved a campaign to active.",
+	zodSchema: z.object({ campaignId: z.string() })
+});
+const CampaignPaused = defineCrmEvent({
+	name: CRM_EVENTS.CAMPAIGN_PAUSED,
+	resource: "campaign",
+	description: "pause() suspended an active campaign.",
+	zodSchema: z.object({
+		campaignId: z.string(),
+		reason: z.string().optional()
+	})
+});
+const CampaignResumed = defineCrmEvent({
+	name: CRM_EVENTS.CAMPAIGN_RESUMED,
+	resource: "campaign",
+	description: "resume() reactivated a paused campaign.",
+	zodSchema: z.object({ campaignId: z.string() })
+});
+const CampaignCompleted = defineCrmEvent({
+	name: CRM_EVENTS.CAMPAIGN_COMPLETED,
+	resource: "campaign",
+	description: "complete() closed a campaign.",
+	zodSchema: z.object({
+		campaignId: z.string(),
+		actualRevenueAmount: z.number().optional()
+	})
+});
+const CampaignArchived = defineCrmEvent({
+	name: CRM_EVENTS.CAMPAIGN_ARCHIVED,
+	resource: "campaign",
+	description: "archive() archived a campaign (terminal).",
+	zodSchema: z.object({ campaignId: z.string() })
+});
+const SubscriptionCreated = defineCrmEvent({
+	name: CRM_EVENTS.SUBSCRIPTION_CREATED,
+	resource: "subscription",
+	description: "subscribe() created an opt-in (pending or confirmed).",
+	zodSchema: z.object({
+		subscriptionId: z.string(),
+		contactId: z.string(),
+		campaignId: z.string(),
+		requiresConfirmation: z.boolean()
+	})
+});
+const SubscriptionConfirmed = defineCrmEvent({
+	name: CRM_EVENTS.SUBSCRIPTION_CONFIRMED,
+	resource: "subscription",
+	description: "confirm() validated a double-opt-in token.",
+	zodSchema: z.object({
+		subscriptionId: z.string(),
+		contactId: z.string(),
+		campaignId: z.string(),
+		confirmedAt: z.iso.datetime()
+	})
+});
+const SubscriptionUnsubscribed = defineCrmEvent({
+	name: CRM_EVENTS.SUBSCRIPTION_UNSUBSCRIBED,
+	resource: "subscription",
+	description: "unsubscribe() opted a contact out (terminal).",
+	zodSchema: z.object({
+		subscriptionId: z.string(),
+		contactId: z.string(),
+		campaignId: z.string(),
+		reason: z.string().optional()
+	})
+});
+const SubscriptionBounced = defineCrmEvent({
+	name: CRM_EVENTS.SUBSCRIPTION_BOUNCED,
+	resource: "subscription",
+	description: "markBounced() recorded a hard bounce (terminal).",
+	zodSchema: z.object({
+		subscriptionId: z.string(),
+		contactId: z.string(),
+		campaignId: z.string(),
+		reason: z.string().optional()
+	})
+});
+const SubscriptionComplained = defineCrmEvent({
+	name: CRM_EVENTS.SUBSCRIPTION_COMPLAINED,
+	resource: "subscription",
+	description: "markComplained() recorded a spam complaint (terminal).",
+	zodSchema: z.object({
+		subscriptionId: z.string(),
+		contactId: z.string(),
+		campaignId: z.string()
+	})
+});
+const emailEventSchema = z.object({
+	eventId: z.string(),
+	kind: z.string(),
+	subjectKind: z.string(),
+	subjectId: z.string(),
+	campaignId: z.string().optional()
+});
+const EmailEventOpened = defineCrmEvent({
+	name: CRM_EVENTS.EMAIL_EVENT_OPENED,
+	resource: "email_event",
+	description: "recordOpen() logged an email open.",
+	zodSchema: emailEventSchema
+});
+const EmailEventClicked = defineCrmEvent({
+	name: CRM_EVENTS.EMAIL_EVENT_CLICKED,
+	resource: "email_event",
+	description: "recordClick() logged a link click.",
+	zodSchema: emailEventSchema
+});
+const EmailEventBounced = defineCrmEvent({
+	name: CRM_EVENTS.EMAIL_EVENT_BOUNCED,
+	resource: "email_event",
+	description: "recordBounce() logged a bounce.",
+	zodSchema: emailEventSchema
+});
+const EmailEventComplained = defineCrmEvent({
+	name: CRM_EVENTS.EMAIL_EVENT_COMPLAINED,
+	resource: "email_event",
+	description: "recordComplaint() logged a spam complaint.",
+	zodSchema: emailEventSchema
+});
+const EmailEventUnsubscribed = defineCrmEvent({
+	name: CRM_EVENTS.EMAIL_EVENT_UNSUBSCRIBED,
+	resource: "email_event",
+	description: "recordUnsubscribe() logged a one-click unsubscribe.",
+	zodSchema: emailEventSchema
+});
+const ConversationCreated = defineCrmEvent({
+	name: CRM_EVENTS.CONVERSATION_CREATED,
+	resource: "conversation",
+	description: "openConversation() started a conversation thread.",
+	zodSchema: z.object({
+		conversationId: z.string(),
+		channel: z.string(),
+		participantKind: z.string(),
+		participantId: z.string()
+	})
+});
+const ConversationAssigned = defineCrmEvent({
+	name: CRM_EVENTS.CONVERSATION_ASSIGNED,
+	resource: "conversation",
+	description: "assign() (re)assigned a conversation owner.",
+	zodSchema: z.object({
+		conversationId: z.string(),
+		assigneeId: z.string(),
+		previousAssigneeId: z.string().optional()
+	})
+});
+const ConversationResolved = defineCrmEvent({
+	name: CRM_EVENTS.CONVERSATION_RESOLVED,
+	resource: "conversation",
+	description: "resolve() closed a conversation.",
+	zodSchema: z.object({
+		conversationId: z.string(),
+		status: z.string(),
+		previousStatus: z.string()
+	})
+});
+const ConversationReopened = defineCrmEvent({
+	name: CRM_EVENTS.CONVERSATION_REOPENED,
+	resource: "conversation",
+	description: "reopen() reopened a resolved conversation.",
+	zodSchema: z.object({
+		conversationId: z.string(),
+		status: z.string(),
+		previousStatus: z.string()
+	})
+});
+const MessageReceived = defineCrmEvent({
+	name: CRM_EVENTS.MESSAGE_RECEIVED,
+	resource: "message",
+	description: "recordInbound() logged an inbound message.",
+	zodSchema: z.object({
+		messageId: z.string(),
+		conversationId: z.string(),
+		direction: z.string(),
+		externalMessageId: z.string().optional()
+	})
+});
+const MessageSent = defineCrmEvent({
+	name: CRM_EVENTS.MESSAGE_SENT,
+	resource: "message",
+	description: "recordOutbound() logged an outbound message.",
+	zodSchema: z.object({
+		messageId: z.string(),
+		conversationId: z.string(),
+		direction: z.string(),
+		externalMessageId: z.string().optional()
+	})
+});
+const crmEventDefinitions = [
+	LeadCreated,
+	LeadStatusChanged,
+	LeadScored,
+	LeadConverted,
+	LeadDisqualified,
+	LeadEnriched,
+	LeadAssigned,
+	AccountCreated,
+	AccountUpdated,
+	AccountEnriched,
+	AccountAssigned,
+	AccountMerged,
+	ContactCreated,
+	ContactUpdated,
+	ContactEnriched,
+	ContactAssigned,
+	ContactMerged,
+	OpportunityCreated,
+	OpportunityStageAdvanced,
+	OpportunityStageRegressed,
+	OpportunityWon,
+	OpportunityLost,
+	OpportunityAbandoned,
+	OpportunityAssigned,
+	OpportunityAmountChanged,
+	OpportunityExtended,
+	PipelineCreated,
+	PipelineArchived,
+	ActivityPlanned,
+	ActivityCompleted,
+	ActivityCancelled,
+	ActivityRescheduled,
+	ActivityOutcomeRecorded,
+	NoteAdded,
+	CampaignCreated,
+	CampaignActivated,
+	CampaignPaused,
+	CampaignResumed,
+	CampaignCompleted,
+	CampaignArchived,
+	SubscriptionCreated,
+	SubscriptionConfirmed,
+	SubscriptionUnsubscribed,
+	SubscriptionBounced,
+	SubscriptionComplained,
+	EmailEventOpened,
+	EmailEventClicked,
+	EmailEventBounced,
+	EmailEventComplained,
+	EmailEventUnsubscribed,
+	ConversationCreated,
+	ConversationAssigned,
+	ConversationResolved,
+	ConversationReopened,
+	MessageReceived,
+	MessageSent
+];
+//#endregion
 //#region src/shared/calculators/forecast.ts
 /**
 * Aggregate opportunities into a forecast table — one row per bucket.
@@ -2753,7 +4305,11 @@ const contactInfoSchema = z.object({
 	email: z.string().email().max(255).optional(),
 	personalEmail: z.string().email().max(255).optional(),
 	phone: z.string().max(50).optional(),
-	alternatePhone: z.string().max(50).optional()
+	alternatePhone: z.string().max(50).optional(),
+	whatsapp: z.string().max(50).optional(),
+	telegram: z.string().max(100).optional(),
+	linkedin: z.string().max(255).optional(),
+	instagram: z.string().max(100).optional()
 });
 const createContactSchema = z.object({
 	name: contactNameSchema,
@@ -2967,6 +4523,4 @@ var validators_exports = /* @__PURE__ */ __exportAll({
 	updatePipelineSchema: () => updatePipelineSchema
 });
 //#endregion
-export { ACTIVITY_MACHINE, ACTIVITY_STATUSES, ACTIVITY_TRANSITIONS, ACTIVITY_TYPES, AccountRepository, ActivityRepository, CAMPAIGN_MACHINE, CAMPAIGN_STATUSES, CAMPAIGN_TRANSITIONS, CRM_EVENTS, CampaignRepository, ContactRepository, CrmError, DuplicateCampaignError, DuplicateLeadError, DuplicateSubscriptionError, EMAIL_EVENT_KINDS, EMAIL_EVENT_SUBJECT_KINDS, EmailEventRepository, EmptyPipelineError, InProcessCrmBus, InvalidActivityTransitionError, InvalidCampaignTransitionError, InvalidConfirmationTokenError, InvalidLeadTransitionError, InvalidOpportunityTransitionError, InvalidSubscriptionTransitionError, InvalidUnsubscribeTokenError, LEAD_MACHINE, LEAD_STATUSES, LEAD_TRANSITIONS, LeadAlreadyConvertedError, LeadRepository, LeadService, LossReasonRepository, NotFoundError, NoteRepository, OPPORTUNITY_MACHINE, OPPORTUNITY_STATUSES, OPPORTUNITY_TRANSITIONS, OpportunityRepository, PipelineRepository, SUBJECT_KINDS, SUBSCRIPTION_MACHINE, SUBSCRIPTION_STATUSES, SUBSCRIPTION_TRANSITIONS, StageNotInPipelineError, SubscriptionRepository, appendStatus, buildAccountSchema, buildActivitySchema, buildCampaignSchema, buildContactSchema, buildEmailEventSchema, buildLeadSchema, buildLossReasonSchema, buildNoteSchema, buildOpportunitySchema, buildPipelineSchema, buildSubscriptionSchema, canTransitionActivity, canTransitionCampaign, canTransitionLead, canTransitionOpportunity, canTransitionSubscription, composeScorers, createAccountModel, createActivityModel, createCampaignModel, createContactModel, createCrm, createCrmModels, createCrmRepositories, createEmailEventModel, createEvent, createLeadModel, createLossReasonModel, createNoteModel, createOpportunityModel, createPipelineModel, createSubscriptionModel, defaultLeadScorer, forecast, lastTransitionTo, latestEntry, pipelineConversion, tenantFieldDef, timeInStatus, validators_exports as validators };
-
-//# sourceMappingURL=index.js.map
+export { ACTIVITY_MACHINE, ACTIVITY_STATUSES, ACTIVITY_TRANSITIONS, ACTIVITY_TYPES, AccountAssigned, AccountCreated, AccountEnriched, AccountMerged, AccountRepository, AccountUpdated, ActivityCancelled, ActivityCompleted, ActivityOutcomeRecorded, ActivityPlanned, ActivityRepository, ActivityRescheduled, CAMPAIGN_MACHINE, CAMPAIGN_STATUSES, CAMPAIGN_TRANSITIONS, CONVERSATION_CHANNELS, CONVERSATION_PARTICIPANT_KINDS, CONVERSATION_STATUSES, CRM_EVENTS, CRM_MODEL_NAMES, CampaignActivated, CampaignArchived, CampaignCompleted, CampaignCreated, CampaignPaused, CampaignRepository, CampaignResumed, ContactAssigned, ContactCreated, ContactEnriched, ContactMerged, ContactRepository, ContactUpdated, ConversationAssigned, ConversationCreated, ConversationReopened, ConversationRepository, ConversationResolved, CrmError, DuplicateCampaignError, DuplicateLeadError, DuplicateSubscriptionError, EMAIL_EVENT_KINDS, EMAIL_EVENT_SUBJECT_KINDS, EmailEventBounced, EmailEventClicked, EmailEventComplained, EmailEventOpened, EmailEventRepository, EmailEventUnsubscribed, EmptyPipelineError, InProcessCrmBus, InvalidActivityTransitionError, InvalidCampaignTransitionError, InvalidConfirmationTokenError, InvalidLeadTransitionError, InvalidOpportunityTransitionError, InvalidSubscriptionTransitionError, InvalidUnsubscribeTokenError, LEAD_MACHINE, LEAD_STATUSES, LEAD_TRANSITIONS, LeadAlreadyConvertedError, LeadAssigned, LeadConverted, LeadCreated, LeadDisqualified, LeadEnriched, LeadRepository, LeadScored, LeadService, LeadStatusChanged, LossReasonRepository, MESSAGE_DELIVERY_STATUSES, MESSAGE_DIRECTIONS, MessageReceived, MessageRepository, MessageSent, NotFoundError, NoteAdded, NoteRepository, OPPORTUNITY_MACHINE, OPPORTUNITY_STATUSES, OPPORTUNITY_TRANSITIONS, OpportunityAbandoned, OpportunityAmountChanged, OpportunityAssigned, OpportunityCreated, OpportunityExtended, OpportunityLost, OpportunityRepository, OpportunityStageAdvanced, OpportunityStageRegressed, OpportunityWon, PipelineArchived, PipelineCreated, PipelineRepository, SUBJECT_KINDS, SUBSCRIPTION_MACHINE, SUBSCRIPTION_STATUSES, SUBSCRIPTION_TRANSITIONS, StageNotInPipelineError, SubscriptionBounced, SubscriptionComplained, SubscriptionConfirmed, SubscriptionCreated, SubscriptionRepository, SubscriptionUnsubscribed, appendStatus, buildAccountSchema, buildActivitySchema, buildCampaignSchema, buildContactSchema, buildConversationSchema, buildEmailEventSchema, buildLeadSchema, buildLossReasonSchema, buildMessageSchema, buildNoteSchema, buildOpportunitySchema, buildPipelineSchema, buildSubscriptionSchema, canTransitionActivity, canTransitionCampaign, canTransitionLead, canTransitionOpportunity, canTransitionSubscription, composeScorers, createAccountModel, createActivityModel, createCampaignModel, createContactModel, createConversationModel, createCrm, createCrmModels, createCrmRepositories, createEmailEventModel, createEvent, createLeadModel, createLossReasonModel, createMessageModel, createNoteModel, createOpportunityModel, createPipelineModel, createSubscriptionModel, crmEventDefinitions, defaultLeadScorer, forecast, lastTransitionTo, latestEntry, pipelineConversion, tenantFieldDef, timeInStatus, validators_exports as validators };