@classytic/crm 0.3.0 → 0.5.0

package/dist/index.js

@@ -1,11 +1,104 @@
-import { t as __exportAll } from "./chunk.js";
+import { t as __exportAll } from "./rolldown-runtime.js";
+import { AccountAssigned, AccountCreated, AccountEnriched, AccountMerged, AccountUpdated, ActivityCancelled, ActivityCompleted, ActivityOutcomeRecorded, ActivityPlanned, ActivityRescheduled, CRM_EVENTS, CampaignActivated, CampaignArchived, CampaignCompleted, CampaignCreated, CampaignPaused, CampaignResumed, ContactAssigned, ContactCreated, ContactEnriched, ContactMerged, ContactUpdated, ConversationAssigned, ConversationCreated, ConversationReopened, ConversationResolved, EmailEventBounced, EmailEventClicked, EmailEventComplained, EmailEventOpened, EmailEventUnsubscribed, InProcessCrmBus, LeadAssigned, LeadConverted, LeadCreated, LeadDisqualified, LeadEnriched, LeadScored, LeadStatusChanged, MessageReceived, MessageSent, NoteAdded, OpportunityAbandoned, OpportunityAmountChanged, OpportunityAssigned, OpportunityCreated, OpportunityExtended, OpportunityLost, OpportunityStageAdvanced, OpportunityStageRegressed, OpportunityWon, PipelineArchived, PipelineCreated, SubscriptionBounced, SubscriptionComplained, SubscriptionConfirmed, SubscriptionCreated, SubscriptionUnsubscribed, createEvent, crmEventDefinitions } from "./events.js";
 import { Schema } from "mongoose";
-import { Repository, aggregateHelpersPlugin, methodRegistryPlugin, multiTenantPlugin } from "@classytic/mongokit";
-import { createEvent as createEvent$1, matchEventPattern } from "@classytic/primitives/events";
+import { Repository, aggregateHelpersPlugin, isDuplicateKeyError, methodRegistryPlugin, multiTenantPlugin } from "@classytic/mongokit";
 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,176 +1388,275 @@ 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)
-	});
-}
-//#endregion
-//#region src/core/errors.ts
+//#region src/enums/conversation.ts
 /**
-* CRM error vocabulary. Hosts catch `CrmError` at API edges.
+* 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.
 */
-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);
-	}
-};
-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/events/event-constants.ts
-/** PACKAGE_RULES rule 12: `package:resource.verb`. */
-const CRM_EVENTS = {
-	LEAD_CREATED: "crm:lead.created",
-	LEAD_STATUS_CHANGED: "crm:lead.status_changed",
-	LEAD_SCORED: "crm:lead.scored",
-	LEAD_CONVERTED: "crm:lead.converted",
-	LEAD_DISQUALIFIED: "crm:lead.disqualified",
-	ACCOUNT_CREATED: "crm:account.created",
-	ACCOUNT_UPDATED: "crm:account.updated",
-	CONTACT_CREATED: "crm:contact.created",
-	CONTACT_UPDATED: "crm:contact.updated",
-	OPPORTUNITY_CREATED: "crm:opportunity.created",
-	OPPORTUNITY_STAGE_ADVANCED: "crm:opportunity.stage_advanced",
-	OPPORTUNITY_STAGE_REGRESSED: "crm:opportunity.stage_regressed",
-	OPPORTUNITY_WON: "crm:opportunity.won",
-	OPPORTUNITY_LOST: "crm:opportunity.lost",
-	OPPORTUNITY_ABANDONED: "crm:opportunity.abandoned",
-	PIPELINE_CREATED: "crm:pipeline.created",
-	PIPELINE_ARCHIVED: "crm:pipeline.archived",
-	ACTIVITY_PLANNED: "crm:activity.planned",
-	ACTIVITY_COMPLETED: "crm:activity.completed",
-	ACTIVITY_CANCELLED: "crm:activity.cancelled",
-	NOTE_ADDED: "crm:note.added",
-	CAMPAIGN_CREATED: "crm:campaign.created",
-	CAMPAIGN_ACTIVATED: "crm:campaign.activated",
-	CAMPAIGN_PAUSED: "crm:campaign.paused",
-	CAMPAIGN_RESUMED: "crm:campaign.resumed",
-	CAMPAIGN_COMPLETED: "crm:campaign.completed",
-	CAMPAIGN_ARCHIVED: "crm:campaign.archived",
-	SUBSCRIPTION_CREATED: "crm:subscription.created",
-	SUBSCRIPTION_CONFIRMED: "crm:subscription.confirmed",
-	SUBSCRIPTION_UNSUBSCRIBED: "crm:subscription.unsubscribed",
-	SUBSCRIPTION_BOUNCED: "crm:subscription.bounced",
-	SUBSCRIPTION_COMPLAINED: "crm:subscription.complained",
-	EMAIL_EVENT_OPENED: "crm:email_event.opened",
-	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"
-};
+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/events/helpers.ts
+//#region src/models/conversation.schema.ts
 /**
-* Event creation helper.
+* Conversation — a multi-channel message thread bound to a Contact or
+* (pre-conversion) Lead. One row per (channel, participant) pair.
 *
-* Thin wrapper around `@classytic/primitives`' `createEvent` that fills the
-* shared `EventMeta` from a `CrmContext` (userId/actorId, organizationId,
-* correlationId). Use this instead of importing `createEvent` directly so
-* the `source: 'crm'` stamp + tenant scoping stay consistent.
+* 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 createEvent(type, payload, ctx, meta) {
-	return createEvent$1(type, payload, {
-		source: "crm",
-		...ctx?.actorId !== void 0 ? { actorId: String(ctx.actorId) } : {},
-		...ctx?.organizationId !== void 0 ? { organizationId: String(ctx.organizationId) } : {},
-		...ctx?.correlationId !== void 0 ? { correlationId: ctx.correlationId } : {},
-		...meta
+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
 	});
-}
-//#endregion
-//#region src/repositories/pipeline.repository.ts
-var PipelineRepository = class extends Repository {
-	events;
-	constructor(model, plugins, deps, pagination) {
+	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/models/message.schema.ts
+/**
+* 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.
+*/
+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
+	}
+}, { _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/repositories/pipeline.repository.ts
+var PipelineRepository = class extends Repository {
+	events;
+	constructor(model, plugins, deps, pagination) {
 		super(model, plugins, pagination);
 		this.events = deps.events;
 	}
@@ -1582,7 +1814,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 +1821,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 +1867,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 +1958,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 +2104,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 +2219,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 +2292,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 +2410,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 +2500,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 +2626,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 +2779,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 +2845,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 +2956,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 +3148,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,46 +3164,29 @@ function createCrmRepositories(models, deps) {
 		activity,
 		note,
 		lossReason,
-		emailEvent
+		emailEvent,
+		conversation,
+		message
 	});
 }
 //#endregion
-//#region src/events/in-process-bus.ts
-/**
-* In-process event bus — default fallback when no `eventTransport` is
-* provided to `createCrm`. Structurally identical to arc's
-* `MemoryEventTransport`; pattern matching is delegated to primitives.
-* Handler errors are swallowed — event emission never blocks writes.
-*/
-var InProcessCrmBus = class {
-	name = "in-process-crm";
-	subs = [];
-	logger;
-	constructor(options) {
-		if (options?.logger) this.logger = options.logger;
-	}
-	async publish(event) {
-		const matching = this.subs.filter((s) => matchEventPattern(s.pattern, event.type));
-		for (const sub of matching) try {
-			await sub.handler(event);
-		} catch (err) {
-			this.logger?.error?.(`[crm] event handler error [${event.type}]`, { error: err instanceof Error ? err.message : String(err) });
-		}
-	}
-	async subscribe(pattern, handler) {
-		const sub = {
-			pattern,
-			handler
-		};
-		this.subs.push(sub);
-		return () => {
-			this.subs = this.subs.filter((s) => s !== sub);
-		};
-	}
-	async close() {
-		this.subs = [];
+//#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) {
@@ -2365,6 +3195,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 +3207,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?.();
 		}
@@ -2753,7 +3592,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 +3810,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 };