@classytic/crm 0.3.0 → 0.5.1

package/dist/index.d.ts

@@ -1,9 +1,8 @@
-import { t as __exportAll } from "./chunk.js";
-import * as mongoose0 from "mongoose";
+import * as _$mongoose from "mongoose";
 import { Connection, Model, Schema, SchemaDefinitionProperty } from "mongoose";
 import { PaginationConfig, PluginType, Repository } from "@classytic/mongokit";
 import { DomainEvent, EventHandler, EventMeta, EventTransport } from "@classytic/primitives/events";
-import * as _classytic_primitives_state_machine0 from "@classytic/primitives/state-machine";
+import * as _$_classytic_primitives_state_machine0 from "@classytic/primitives/state-machine";
 import { z } from "zod";
 import { StatusChangeEntry, StatusHistory, appendStatus, lastTransitionTo, latestEntry, timeInStatus } from "@classytic/primitives/status-history";
 import { OperationContext } from "@classytic/primitives/context";
@@ -23,7 +22,7 @@ declare function tenantFieldDef(config: SchemaBuildConfig): SchemaDefinitionProp
 //#region src/models/pipeline.schema.d.ts
 /** Mongoose document shape for a single embedded stage. */
 interface IStageDocument {
-  _id: mongoose0.Types.ObjectId;
+  _id: _$mongoose.Types.ObjectId;
   name: string;
   /** Ascending order in the pipeline. Treated as identifier on `moveToStage`. */
   sequence: number;
@@ -34,8 +33,8 @@ interface IStageDocument {
 }
 /** Mongoose document shape for a Pipeline. */
 interface IPipelineDocument {
-  _id: mongoose0.Types.ObjectId;
-  organizationId: mongoose0.Types.ObjectId | string;
+  _id: _$mongoose.Types.ObjectId;
+  organizationId: _$mongoose.Types.ObjectId | string;
   name: string;
   /** Deprecates the pipeline — existing opps still move, no new ones created. */
   isArchived: boolean;
@@ -74,8 +73,8 @@ interface ILeadStatusEntry {
   note?: string;
 }
 interface ILeadDocument {
-  _id: mongoose0.Types.ObjectId;
-  organizationId: mongoose0.Types.ObjectId | string;
+  _id: _$mongoose.Types.ObjectId;
+  organizationId: _$mongoose.Types.ObjectId | string;
   fullName: string;
   firstName?: string;
   lastName?: string;
@@ -90,9 +89,9 @@ interface ILeadDocument {
   statusHistory: ILeadStatusEntry[];
   ownerId?: string;
   tags: string[];
-  convertedContactId?: mongoose0.Types.ObjectId | string;
-  convertedAccountId?: mongoose0.Types.ObjectId | string;
-  convertedOpportunityId?: mongoose0.Types.ObjectId | string;
+  convertedContactId?: _$mongoose.Types.ObjectId | string;
+  convertedAccountId?: _$mongoose.Types.ObjectId | string;
+  convertedOpportunityId?: _$mongoose.Types.ObjectId | string;
   convertedAt?: Date;
   disqualifyReason?: string;
   metadata?: Record<string, unknown>;
@@ -124,12 +123,12 @@ interface IOpportunityStatusEntry {
   note?: string;
 }
 interface IOpportunityDocument {
-  _id: mongoose0.Types.ObjectId;
-  organizationId: mongoose0.Types.ObjectId | string;
+  _id: _$mongoose.Types.ObjectId;
+  organizationId: _$mongoose.Types.ObjectId | string;
   name: string;
-  accountId?: mongoose0.Types.ObjectId | string;
-  primaryContactId?: mongoose0.Types.ObjectId | string;
-  pipelineId: mongoose0.Types.ObjectId | string;
+  accountId?: _$mongoose.Types.ObjectId | string;
+  primaryContactId?: _$mongoose.Types.ObjectId | string;
+  pipelineId: _$mongoose.Types.ObjectId | string;
   stageId: string;
   status: OpportunityStatus;
   statusHistory: IOpportunityStatusEntry[];
@@ -138,9 +137,9 @@ interface IOpportunityDocument {
   probability: number;
   expectedCloseAt?: Date;
   closedAt?: Date;
-  lostReasonId?: mongoose0.Types.ObjectId | string;
+  lostReasonId?: _$mongoose.Types.ObjectId | string;
   ownerId?: string;
-  sourceLeadId?: mongoose0.Types.ObjectId | string;
+  sourceLeadId?: _$mongoose.Types.ObjectId | string;
   tags: string[];
   metadata?: Record<string, unknown>;
   createdAt: Date;
@@ -163,14 +162,18 @@ interface IContactInfoEmbedded {
   personalEmail?: string;
   phone?: string;
   alternatePhone?: string;
+  whatsapp?: string;
+  telegram?: string;
+  linkedin?: string;
+  instagram?: string;
 }
 interface IContactDocument {
-  _id: mongoose0.Types.ObjectId;
-  organizationId: mongoose0.Types.ObjectId | string;
+  _id: _$mongoose.Types.ObjectId;
+  organizationId: _$mongoose.Types.ObjectId | string;
   name: IContactName;
   contact: IContactInfoEmbedded;
   jobTitle?: string;
-  accountId?: mongoose0.Types.ObjectId | string;
+  accountId?: _$mongoose.Types.ObjectId | string;
   ownerId?: string;
   tags: string[];
   metadata?: Record<string, unknown>;
@@ -182,8 +185,8 @@ declare function createContactModel(connection: Connection, config: SchemaBuildC
 //#endregion
 //#region src/models/account.schema.d.ts
 interface IAccountDocument {
-  _id: mongoose0.Types.ObjectId;
-  organizationId: mongoose0.Types.ObjectId | string;
+  _id: _$mongoose.Types.ObjectId;
+  organizationId: _$mongoose.Types.ObjectId | string;
   name: string;
   domain?: string;
   industry?: string;
@@ -222,8 +225,8 @@ interface ICampaignStatusEntry {
   note?: string;
 }
 interface ICampaignDocument {
-  _id: mongoose0.Types.ObjectId;
-  organizationId: mongoose0.Types.ObjectId | string;
+  _id: _$mongoose.Types.ObjectId;
+  organizationId: _$mongoose.Types.ObjectId | string;
   name: string;
   description?: string;
   status: CampaignStatus;
@@ -273,10 +276,10 @@ interface ISubscriptionStatusEntry {
   note?: string;
 }
 interface ISubscriptionDocument {
-  _id: mongoose0.Types.ObjectId;
-  organizationId: mongoose0.Types.ObjectId | string;
-  contactId: mongoose0.Types.ObjectId | string;
-  campaignId: mongoose0.Types.ObjectId | string;
+  _id: _$mongoose.Types.ObjectId;
+  organizationId: _$mongoose.Types.ObjectId | string;
+  contactId: _$mongoose.Types.ObjectId | string;
+  campaignId: _$mongoose.Types.ObjectId | string;
   status: SubscriptionStatus;
   statusHistory: ISubscriptionStatusEntry[];
   source?: string;
@@ -321,12 +324,12 @@ type SubjectKind = (typeof SUBJECT_KINDS)[number];
 //#endregion
 //#region src/models/activity.schema.d.ts
 interface IActivityDocument {
-  _id: mongoose0.Types.ObjectId;
-  organizationId: mongoose0.Types.ObjectId | string;
+  _id: _$mongoose.Types.ObjectId;
+  organizationId: _$mongoose.Types.ObjectId | string;
   type: ActivityType;
   status: ActivityStatus;
   subjectKind: SubjectKind;
-  subjectId: mongoose0.Types.ObjectId | string;
+  subjectId: _$mongoose.Types.ObjectId | string;
   title: string;
   description?: string;
   ownerId?: string;
@@ -343,10 +346,10 @@ declare function createActivityModel(connection: Connection, config: SchemaBuild
 //#endregion
 //#region src/models/note.schema.d.ts
 interface INoteDocument {
-  _id: mongoose0.Types.ObjectId;
-  organizationId: mongoose0.Types.ObjectId | string;
+  _id: _$mongoose.Types.ObjectId;
+  organizationId: _$mongoose.Types.ObjectId | string;
   subjectKind: SubjectKind;
-  subjectId: mongoose0.Types.ObjectId | string;
+  subjectId: _$mongoose.Types.ObjectId | string;
   body: string;
   authorId?: string;
   pinned: boolean;
@@ -359,8 +362,8 @@ declare function createNoteModel(connection: Connection, config: SchemaBuildConf
 //#endregion
 //#region src/models/loss-reason.schema.d.ts
 interface ILossReasonDocument {
-  _id: mongoose0.Types.ObjectId;
-  organizationId: mongoose0.Types.ObjectId | string;
+  _id: _$mongoose.Types.ObjectId;
+  organizationId: _$mongoose.Types.ObjectId | string;
   name: string;
   description?: string;
   isActive: boolean;
@@ -402,18 +405,17 @@ declare function createLossReasonModel(connection: Connection, config: SchemaBui
  */
 declare const EMAIL_EVENT_KINDS: readonly ["open", "click", "bounce", "complaint", "unsubscribe"];
 type EmailEventKind = (typeof EMAIL_EVENT_KINDS)[number];
-/** Engagement (positive signal). */
 //#endregion
 //#region src/models/email-event.schema.d.ts
 declare const EMAIL_EVENT_SUBJECT_KINDS: readonly ["contact", "subscription"];
 type EmailEventSubjectKind = (typeof EMAIL_EVENT_SUBJECT_KINDS)[number];
 interface IEmailEventDocument {
-  _id: mongoose0.Types.ObjectId;
-  organizationId: mongoose0.Types.ObjectId | string;
+  _id: _$mongoose.Types.ObjectId;
+  organizationId: _$mongoose.Types.ObjectId | string;
   kind: EmailEventKind;
   subjectKind: EmailEventSubjectKind;
-  subjectId: mongoose0.Types.ObjectId | string;
-  campaignId?: mongoose0.Types.ObjectId | string;
+  subjectId: _$mongoose.Types.ObjectId | string;
+  campaignId?: _$mongoose.Types.ObjectId | string;
   messageId?: string;
   url?: string;
   userAgent?: string;
@@ -424,6 +426,82 @@ interface IEmailEventDocument {
 declare function buildEmailEventSchema(config: SchemaBuildConfig): Schema<IEmailEventDocument>;
 declare function createEmailEventModel(connection: Connection, config: SchemaBuildConfig): Model<IEmailEventDocument>;
 //#endregion
+//#region src/enums/conversation.d.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.
+ */
+declare const CONVERSATION_CHANNELS: readonly ["whatsapp", "telegram", "email", "instagram_dm", "sms", "web_chat"];
+type ConversationChannel = (typeof CONVERSATION_CHANNELS)[number];
+declare const CONVERSATION_STATUSES: readonly ["open", "snoozed", "resolved"];
+type ConversationStatus = (typeof CONVERSATION_STATUSES)[number];
+/** Conversations attach to either a Contact or a (yet-unconverted) Lead. */
+declare const CONVERSATION_PARTICIPANT_KINDS: readonly ["contact", "lead"];
+type ConversationParticipantKind = (typeof CONVERSATION_PARTICIPANT_KINDS)[number];
+declare const MESSAGE_DIRECTIONS: readonly ["inbound", "outbound"];
+type MessageDirection = (typeof MESSAGE_DIRECTIONS)[number];
+declare const MESSAGE_DELIVERY_STATUSES: readonly ["queued", "sent", "delivered", "read", "failed"];
+type MessageDeliveryStatus = (typeof MESSAGE_DELIVERY_STATUSES)[number];
+//#endregion
+//#region src/models/conversation.schema.d.ts
+interface IConversationDocument {
+  _id: _$mongoose.Types.ObjectId;
+  organizationId: _$mongoose.Types.ObjectId | string;
+  channel: ConversationChannel;
+  participantKind: ConversationParticipantKind;
+  participantId: _$mongoose.Types.ObjectId | string;
+  /** Channel-side identifier (e.g. WhatsApp wa_id, Telegram chat id). */
+  channelUserId?: string;
+  status: ConversationStatus;
+  /** Last message timestamp — surfaced for inbox sort + idle SLAs. */
+  lastMessageAt?: Date;
+  /** Unread inbound count. Reset to 0 on `markRead`. */
+  unreadCount: number;
+  /** Assignee. Stored as a string so hosts can use either userId or a queue id. */
+  assigneeId?: string;
+  /** Free-form bag — channel-specific settings (preview text, IMAP folder). */
+  metadata?: Record<string, unknown>;
+  createdAt: Date;
+  updatedAt: Date;
+}
+declare function buildConversationSchema(config: SchemaBuildConfig): Schema<IConversationDocument>;
+declare function createConversationModel(connection: Connection, config: SchemaBuildConfig): Model<IConversationDocument>;
+//#endregion
+//#region src/models/message.schema.d.ts
+interface IMessageAttachment {
+  type: string;
+  url: string;
+  name?: string;
+  size?: number;
+  mimeType?: string;
+}
+interface IMessageDocument {
+  _id: _$mongoose.Types.ObjectId;
+  organizationId: _$mongoose.Types.ObjectId | string;
+  conversationId: _$mongoose.Types.ObjectId | string;
+  direction: MessageDirection;
+  body: string;
+  attachments: IMessageAttachment[];
+  /** Provider-side id — webhook dedup key. */
+  externalMessageId?: string;
+  status: MessageDeliveryStatus;
+  /** Channel id of the sender (phone number, email, telegram id). */
+  senderRef?: string;
+  /** Channel id of the recipient. */
+  recipientRef?: string;
+  /** When the wire said it left / arrived; falls back to createdAt. */
+  sentAt?: Date;
+  metadata?: Record<string, unknown>;
+  createdAt: Date;
+  updatedAt: Date;
+}
+declare function buildMessageSchema(config: SchemaBuildConfig): Schema<IMessageDocument>;
+declare function createMessageModel(connection: Connection, config: SchemaBuildConfig): Model<IMessageDocument>;
+//#endregion
 //#region src/models/create-models.d.ts
 interface CrmModels {
   Pipeline: Model<IPipelineDocument>;
@@ -437,8 +515,22 @@ interface CrmModels {
   Note: Model<INoteDocument>;
   LossReason: Model<ILossReasonDocument>;
   EmailEvent: Model<IEmailEventDocument>;
+  Conversation: Model<IConversationDocument>;
+  Message: Model<IMessageDocument>;
 }
-declare function createCrmModels(connection: Connection, config: SchemaBuildConfig): CrmModels;
+/** Mongoose model names this package registers — drives the §21 collision check. */
+declare const CRM_MODEL_NAMES: readonly ["Pipeline", "Lead", "Opportunity", "Contact", "Account", "Campaign", "EmailSubscription", "Activity", "Note", "LossReason", "EmailEvent", "Conversation", "Message"];
+interface CreateModelsOptions extends SchemaBuildConfig {
+  /**
+   * On a model-name collision: `false` (default) throws
+   * `CrmModelCollisionError`; `true` deletes + re-registers (test
+   * fixtures / hot reload only).
+   */
+  forceRecreate?: boolean;
+  /** Mongoose auto-index builds. Default `true` (dev); `false` in prod. */
+  autoIndex?: boolean;
+}
+declare function createCrmModels(connection: Connection, config: CreateModelsOptions): CrmModels;
 //#endregion
 //#region src/repositories/pipeline.repository.d.ts
 interface PipelineRepositoryDeps {
@@ -506,12 +598,38 @@ declare class LeadRepository extends Repository<ILeadDocument> {
   qualify(id: string, extras?: TransitionExtras, ctx?: CrmContext): Promise<ILeadDocument>;
   disqualify(id: string, reason: string, extras?: Omit<TransitionExtras, 'patch'>, ctx?: CrmContext): Promise<ILeadDocument>;
   nurture(id: string, extras?: TransitionExtras, ctx?: CrmContext): Promise<ILeadDocument>;
+  /**
+   * 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.
+   */
+  enrich(id: string, patch: Partial<ILeadDocument>, extras?: {
+    provider?: string;
+  }, ctx?: CrmContext): Promise<ILeadDocument>;
+  /**
+   * Assign / re-assign the lead's owner. Emits `crm:lead.assigned` with
+   * the previous owner so audit consumers can compute hand-off chains.
+   */
+  assign(id: string, ownerId: string, ctx?: CrmContext): Promise<ILeadDocument>;
   /**
    * Recompute + persist the lead's score. Called from `createLead`
    * automatically; hosts also call this after enrichment writes.
    */
   recomputeScore(id: string, ctx?: CrmContext): Promise<ILeadDocument>;
   private _transition;
+  /**
+   * 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).
+   */
+  countCreatedSince(since: Date, ctx?: CrmContext): Promise<number>;
+  /** Latest `limit` leads — lightweight projection for the activity feed. */
+  findRecentForFeed(limit: number, ctx?: CrmContext): Promise<ILeadDocument[]>;
 }
 //#endregion
 //#region src/repositories/opportunity.repository.d.ts
@@ -564,14 +682,65 @@ declare class OpportunityRepository extends Repository<IOpportunityDocument> {
   moveToStage(id: string, input: MoveStageInput, ctx?: CrmContext): Promise<IOpportunityDocument>;
   win(id: string, input?: CloseInput, ctx?: CrmContext): Promise<IOpportunityDocument>;
   lose(id: string, input?: CloseInput, ctx?: CrmContext): Promise<IOpportunityDocument>;
+  /**
+   * Re-assign opportunity owner. Mutates `ownerId` only; no status
+   * transition. Emits `crm:opportunity.assigned` with the previous owner.
+   */
+  assign(id: string, ownerId: string, ctx?: CrmContext): Promise<IOpportunityDocument>;
+  /**
+   * 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.
+   */
+  updateAmount(id: string, amount: number, extras?: {
+    reason?: string;
+    by?: string;
+  }, ctx?: CrmContext): Promise<IOpportunityDocument>;
+  /**
+   * 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).
+   */
+  extendCloseDate(id: string, newDate: Date, extras?: {
+    reason?: string;
+    by?: string;
+  }, ctx?: CrmContext): Promise<IOpportunityDocument>;
   abandon(id: string, by?: string, note?: string, ctx?: CrmContext): Promise<IOpportunityDocument>;
   private _closeStatus;
+  /** Count opportunities with status `open`. Used by dashboard KPI tiles. */
+  countOpen(ctx?: CrmContext): Promise<number>;
+  /**
+   * 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).
+   */
+  sumWonSince(since: Date, ctx?: CrmContext): Promise<{
+    total: number;
+    currency?: string;
+  } | null>;
+  /** Latest `limit` opportunities — lightweight projection for the activity feed. */
+  findRecentForFeed(limit: number, ctx?: CrmContext): Promise<IOpportunityDocument[]>;
 }
 //#endregion
 //#region src/repositories/contact.repository.d.ts
 interface ContactRepositoryDeps {
   events: EventTransport;
 }
+interface MergeContactInput {
+  /** Surviving contact id. Receives merged fields. */
+  primaryId: string;
+  /** Secondary contact id. Deleted after merge. */
+  secondaryId: string;
+  /**
+   * Per-field strategy. Defaults to `'preferPrimary'` — primary's
+   * non-empty fields win, secondary fills the gaps. Use `'preferSecondary'`
+   * for the reverse. `tags` are always unioned.
+   */
+  strategy?: 'preferPrimary' | 'preferSecondary';
+}
 declare class ContactRepository extends Repository<IContactDocument> {
   private readonly events;
   constructor(model: Model<IContactDocument>, plugins: PluginType[], deps: ContactRepositoryDeps, pagination?: PaginationConfig);
@@ -580,16 +749,49 @@ declare class ContactRepository extends Repository<IContactDocument> {
    * `create()` when they want the event side-effect (e.g. webhook fan-out).
    */
   createContact(input: Partial<IContactDocument>, ctx?: CrmContext): Promise<IContactDocument>;
+  /**
+   * 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).
+   */
+  enrich(id: string, patch: Partial<IContactDocument>, extras?: {
+    provider?: string;
+  }, ctx?: CrmContext): Promise<IContactDocument>;
+  /** Set / re-assign the contact's owner. Atomic; no-op when unchanged. */
+  assign(id: string, ownerId: string, ctx?: CrmContext): Promise<IContactDocument>;
+  /**
+   * 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.
+   */
+  merge(input: MergeContactInput, ctx?: CrmContext): Promise<IContactDocument>;
 }
 //#endregion
 //#region src/repositories/account.repository.d.ts
 interface AccountRepositoryDeps {
   events: EventTransport;
 }
+interface MergeAccountInput {
+  primaryId: string;
+  secondaryId: string;
+  strategy?: 'preferPrimary' | 'preferSecondary';
+}
 declare class AccountRepository extends Repository<IAccountDocument> {
   private readonly events;
   constructor(model: Model<IAccountDocument>, plugins: PluginType[], deps: AccountRepositoryDeps, pagination?: PaginationConfig);
   createAccount(input: Partial<IAccountDocument>, ctx?: CrmContext): Promise<IAccountDocument>;
+  enrich(id: string, patch: Partial<IAccountDocument>, extras?: {
+    provider?: string;
+  }, ctx?: CrmContext): Promise<IAccountDocument>;
+  assign(id: string, ownerId: string, ctx?: CrmContext): Promise<IAccountDocument>;
+  merge(input: MergeAccountInput, ctx?: CrmContext): Promise<IAccountDocument>;
 }
 //#endregion
 //#region src/repositories/campaign.repository.d.ts
@@ -655,7 +857,30 @@ declare class ActivityRepository extends Repository<IActivityDocument> {
   start(id: string, ctx?: CrmContext): Promise<IActivityDocument>;
   complete(id: string, completedAt?: Date, ctx?: CrmContext): Promise<IActivityDocument>;
   cancel(id: string, reason?: string, ctx?: CrmContext): Promise<IActivityDocument>;
+  /**
+   * 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.
+   */
+  reschedule(id: string, newDueDate: Date, extras?: {
+    reason?: string;
+    by?: string;
+  }, ctx?: CrmContext): Promise<IActivityDocument>;
+  /**
+   * 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.
+   */
+  recordOutcome(id: string, outcome: Record<string, unknown>, ctx?: CrmContext): Promise<IActivityDocument>;
   private _transition;
+  /** Count `planned` activities with `dueDate` before `asOf`. Dashboard KPI. */
+  countOverduePlanned(asOf: Date, ctx?: CrmContext): Promise<number>;
+  /** Latest `limit` activities — lightweight projection for the activity feed. */
+  findRecentForFeed(limit: number, ctx?: CrmContext): Promise<IActivityDocument[]>;
 }
 //#endregion
 //#region src/repositories/note.repository.d.ts
@@ -704,6 +929,68 @@ declare class EmailEventRepository extends Repository<IEmailEventDocument> {
   private _record;
 }
 //#endregion
+//#region src/repositories/conversation.repository.d.ts
+interface ConversationRepositoryDeps {
+  events: EventTransport;
+}
+interface OpenConversationInput {
+  channel: ConversationChannel;
+  participantKind: ConversationParticipantKind;
+  participantId: string;
+  channelUserId?: string;
+  assigneeId?: string;
+  metadata?: Record<string, unknown>;
+}
+declare class ConversationRepository extends Repository<IConversationDocument> {
+  private readonly events;
+  constructor(model: Model<IConversationDocument>, plugins: PluginType[], deps: ConversationRepositoryDeps, pagination?: PaginationConfig);
+  openConversation(input: OpenConversationInput, ctx?: CrmContext): Promise<IConversationDocument>;
+  assign(id: string, assigneeId: string, ctx?: CrmContext): Promise<IConversationDocument>;
+  resolve(id: string, ctx?: CrmContext): Promise<IConversationDocument>;
+  reopen(id: string, ctx?: CrmContext): Promise<IConversationDocument>;
+  /** Reset unread badge. Pure UI affordance, no event. */
+  markRead(id: string, ctx?: CrmContext): Promise<IConversationDocument>;
+  /**
+   * 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.
+   */
+  touch(id: string, args: {
+    direction: 'inbound' | 'outbound';
+    sentAt: Date;
+  }, ctx?: CrmContext): Promise<IConversationDocument | null>;
+  private _setStatus;
+}
+//#endregion
+//#region src/repositories/message.repository.d.ts
+interface MessageRepositoryDeps {
+  events: EventTransport;
+  conversations: ConversationRepository;
+}
+interface RecordMessageInput {
+  conversationId: string;
+  body: string;
+  attachments?: IMessageAttachment[];
+  externalMessageId?: string;
+  senderRef?: string;
+  recipientRef?: string;
+  sentAt?: Date;
+  metadata?: Record<string, unknown>;
+}
+declare class MessageRepository extends Repository<IMessageDocument> {
+  private readonly events;
+  private readonly conversations;
+  constructor(model: Model<IMessageDocument>, plugins: PluginType[], deps: MessageRepositoryDeps, pagination?: PaginationConfig);
+  recordInbound(input: RecordMessageInput, ctx?: CrmContext): Promise<IMessageDocument>;
+  recordOutbound(input: RecordMessageInput, ctx?: CrmContext): Promise<IMessageDocument>;
+  /** Wire delivery callback (e.g. WhatsApp `status` webhook). */
+  updateStatus(id: string, status: MessageDeliveryStatus, ctx?: CrmContext): Promise<IMessageDocument>;
+  private _record;
+  /** Latest `limit` messages — lightweight projection for the activity feed. */
+  findRecentForFeed(limit: number, ctx?: CrmContext): Promise<IMessageDocument[]>;
+}
+//#endregion
 //#region src/engine/engine-types.d.ts
 interface CrmLogger {
   info?(msg: string, meta?: Record<string, unknown>): void;
@@ -735,11 +1022,31 @@ interface CrmConfig {
   pagination?: PaginationConfig;
   /** Extra mongokit plugins applied to every repository (after defaults). */
   plugins?: PluginType[];
+  /**
+   * On a Mongoose model-name collision (another engine / hot reload owns
+   * the name): `false` (default) throws `CrmModelCollisionError`; `true`
+   * deletes + re-registers. Test fixtures / hot reload only (§21).
+   */
+  forceRecreate?: boolean;
+  /**
+   * Mongoose auto-index builds. Default `true` (dev). Set `false` in
+   * production and run `engine.syncIndexes()` from a deploy script so
+   * cold-boot index builds don't blow Fastify's plugin timeout (§35).
+   */
+  autoIndex?: boolean;
+  /**
+   * Skip the boot-time `transactions` capability requirement, downgrading
+   * it to a warning. Set only when the host never calls
+   * `LeadService.convert()` inside a transaction (standalone Mongo).
+   */
+  allowNonTransactional?: boolean;
 }
 interface ResolvedCrmConfig extends SchemaBuildConfig {
   connection: Connection;
   tenantFieldType: TenantFieldType;
   multiTenant: boolean;
+  forceRecreate: boolean;
+  autoIndex: boolean;
   logger?: CrmLogger;
   pagination?: PaginationConfig;
   plugins: PluginType[];
@@ -756,6 +1063,8 @@ interface CrmRepositories {
   note: NoteRepository;
   lossReason: LossReasonRepository;
   emailEvent: EmailEventRepository;
+  conversation: ConversationRepository;
+  message: MessageRepository;
 }
 interface CrmEngine {
   /** Repositories ARE the API surface (PACKAGE_RULES §1). */
@@ -766,6 +1075,11 @@ interface CrmEngine {
   readonly models: Readonly<CrmModels>;
   /** Resolved configuration (frozen). */
   readonly config: Readonly<ResolvedCrmConfig>;
+  /**
+   * Build/align every model's indexes against its schema. Call once per
+   * deploy when booted with `autoIndex: false` (§35). Idempotent.
+   */
+  syncIndexes(): Promise<void>;
   /** Release resources. Safe to call multiple times. */
   dispose(): Promise<void>;
 }
@@ -776,8 +1090,8 @@ interface CrmEngine {
  * `metadata?` field — keep the typed surface tight.
  */
 interface CrmContext extends OperationContext {
-  organizationId?: string | mongoose0.Types.ObjectId;
-  actorId?: string | mongoose0.Types.ObjectId;
+  organizationId?: string | _$mongoose.Types.ObjectId;
+  actorId?: string | _$mongoose.Types.ObjectId;
   /** Mongo transaction session (passed through to mongokit). */
   session?: unknown;
 }
@@ -809,11 +1123,11 @@ interface ConvertResult {
   contact: IContactDocument;
   account?: IAccountDocument;
   opportunity: IOpportunityDocument;
-  /** @deprecated use contact._id */
+  /** Convenience string id — same as `String(contact._id)`. */
   contactId: string;
-  /** @deprecated use account._id */
+  /** Convenience string id — present only when an account was created. */
   accountId?: string;
-  /** @deprecated use opportunity._id */
+  /** Convenience string id — same as `String(opportunity._id)`. */
   opportunityId: string;
 }
 interface LeadServiceDeps {
@@ -899,9 +1213,337 @@ declare const CRM_EVENTS: {
   readonly EMAIL_EVENT_BOUNCED: "crm:email_event.bounced";
   readonly EMAIL_EVENT_COMPLAINED: "crm:email_event.complained";
   readonly EMAIL_EVENT_UNSUBSCRIBED: "crm:email_event.unsubscribed";
+  readonly LEAD_ENRICHED: "crm:lead.enriched";
+  readonly LEAD_ASSIGNED: "crm:lead.assigned";
+  readonly CONTACT_ENRICHED: "crm:contact.enriched";
+  readonly CONTACT_ASSIGNED: "crm:contact.assigned";
+  readonly CONTACT_MERGED: "crm:contact.merged";
+  readonly ACCOUNT_ENRICHED: "crm:account.enriched";
+  readonly ACCOUNT_ASSIGNED: "crm:account.assigned";
+  readonly ACCOUNT_MERGED: "crm:account.merged";
+  readonly OPPORTUNITY_ASSIGNED: "crm:opportunity.assigned";
+  readonly OPPORTUNITY_AMOUNT_CHANGED: "crm:opportunity.amount_changed";
+  readonly OPPORTUNITY_EXTENDED: "crm:opportunity.extended";
+  readonly ACTIVITY_RESCHEDULED: "crm:activity.rescheduled";
+  readonly ACTIVITY_OUTCOME_RECORDED: "crm:activity.outcome_recorded";
+  readonly CONVERSATION_CREATED: "crm:conversation.created";
+  readonly CONVERSATION_ASSIGNED: "crm:conversation.assigned";
+  readonly CONVERSATION_RESOLVED: "crm:conversation.resolved";
+  readonly CONVERSATION_REOPENED: "crm:conversation.reopened";
+  readonly MESSAGE_RECEIVED: "crm:message.received";
+  readonly MESSAGE_SENT: "crm:message.sent";
 };
 type CrmEventName = (typeof CRM_EVENTS)[keyof typeof CRM_EVENTS];
 //#endregion
+//#region src/events/event-catalog.d.ts
+/** JSON-Schema object produced by `z.toJSONSchema` — what arc's registry consumes. */
+type CrmEventSchema = Record<string, unknown>;
+/** Structurally identical to arc's `EventDefinitionOutput` — do NOT import arc. */
+interface CrmEventDefinition<TSchema extends z.ZodType = z.ZodType> {
+  name: CrmEventName;
+  version: number;
+  description: string;
+  zodSchema: TSchema;
+  schema: CrmEventSchema;
+  create(payload: z.infer<TSchema>, meta?: Partial<EventMeta>): DomainEvent<z.infer<TSchema>>;
+}
+declare const LeadCreated: CrmEventDefinition<z.ZodObject<{
+  leadId: z.ZodString;
+  email: z.ZodOptional<z.ZodString>;
+  score: z.ZodNumber;
+}, z.core.$strip>>;
+declare const LeadStatusChanged: CrmEventDefinition<z.ZodObject<{
+  leadId: z.ZodString;
+  from: z.ZodString;
+  to: z.ZodString;
+}, z.core.$strip>>;
+declare const LeadScored: CrmEventDefinition<z.ZodObject<{
+  leadId: z.ZodString;
+  score: z.ZodNumber;
+}, z.core.$strip>>;
+declare const LeadConverted: CrmEventDefinition<z.ZodObject<{
+  leadId: z.ZodString;
+  contactId: z.ZodString;
+  accountId: z.ZodOptional<z.ZodString>;
+  opportunityId: z.ZodString;
+}, z.core.$strip>>;
+declare const LeadDisqualified: CrmEventDefinition<z.ZodObject<{
+  leadId: z.ZodString;
+  reason: z.ZodString;
+}, z.core.$strip>>;
+declare const LeadEnriched: CrmEventDefinition<z.ZodObject<{
+  leadId: z.ZodString;
+  fields: z.ZodArray<z.ZodString>;
+  provider: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const LeadAssigned: CrmEventDefinition<z.ZodObject<{
+  leadId: z.ZodString;
+  ownerId: z.ZodString;
+  previousOwnerId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const AccountCreated: CrmEventDefinition<z.ZodObject<{
+  accountId: z.ZodString;
+  name: z.ZodString;
+}, z.core.$strip>>;
+declare const AccountUpdated: CrmEventDefinition<z.ZodObject<{
+  accountId: z.ZodString;
+}, z.core.$strip>>;
+declare const AccountEnriched: CrmEventDefinition<z.ZodObject<{
+  accountId: z.ZodString;
+  fields: z.ZodArray<z.ZodString>;
+  provider: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const AccountAssigned: CrmEventDefinition<z.ZodObject<{
+  accountId: z.ZodString;
+  ownerId: z.ZodString;
+  previousOwnerId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const AccountMerged: CrmEventDefinition<z.ZodObject<{
+  primaryId: z.ZodString;
+  secondaryId: z.ZodString;
+  strategy: z.ZodEnum<{
+    preferPrimary: "preferPrimary";
+    preferSecondary: "preferSecondary";
+  }>;
+}, z.core.$strip>>;
+declare const ContactCreated: CrmEventDefinition<z.ZodObject<{
+  contactId: z.ZodString;
+  email: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const ContactUpdated: CrmEventDefinition<z.ZodObject<{
+  contactId: z.ZodString;
+}, z.core.$strip>>;
+declare const ContactEnriched: CrmEventDefinition<z.ZodObject<{
+  contactId: z.ZodString;
+  fields: z.ZodArray<z.ZodString>;
+  provider: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const ContactAssigned: CrmEventDefinition<z.ZodObject<{
+  contactId: z.ZodString;
+  ownerId: z.ZodString;
+  previousOwnerId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const ContactMerged: CrmEventDefinition<z.ZodObject<{
+  primaryId: z.ZodString;
+  secondaryId: z.ZodString;
+  strategy: z.ZodEnum<{
+    preferPrimary: "preferPrimary";
+    preferSecondary: "preferSecondary";
+  }>;
+}, z.core.$strip>>;
+declare const OpportunityCreated: CrmEventDefinition<z.ZodObject<{
+  opportunityId: z.ZodString;
+  pipelineId: z.ZodString;
+  stageId: z.ZodString;
+}, z.core.$strip>>;
+declare const OpportunityStageAdvanced: CrmEventDefinition<z.ZodObject<{
+  opportunityId: z.ZodString;
+  from: z.ZodObject<{
+    stageId: z.ZodString;
+    sequence: z.ZodNumber;
+  }, z.core.$strip>;
+  to: z.ZodObject<{
+    stageId: z.ZodString;
+    sequence: z.ZodNumber;
+  }, z.core.$strip>;
+}, z.core.$strip>>;
+declare const OpportunityStageRegressed: CrmEventDefinition<z.ZodObject<{
+  opportunityId: z.ZodString;
+  from: z.ZodObject<{
+    stageId: z.ZodString;
+    sequence: z.ZodNumber;
+  }, z.core.$strip>;
+  to: z.ZodObject<{
+    stageId: z.ZodString;
+    sequence: z.ZodNumber;
+  }, z.core.$strip>;
+}, z.core.$strip>>;
+declare const OpportunityWon: CrmEventDefinition<z.ZodObject<{
+  opportunityId: z.ZodString;
+  amount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+declare const OpportunityLost: CrmEventDefinition<z.ZodObject<{
+  opportunityId: z.ZodString;
+  lostReasonId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const OpportunityAbandoned: CrmEventDefinition<z.ZodObject<{
+  opportunityId: z.ZodString;
+}, z.core.$strip>>;
+declare const OpportunityAssigned: CrmEventDefinition<z.ZodObject<{
+  opportunityId: z.ZodString;
+  ownerId: z.ZodString;
+  previousOwnerId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const OpportunityAmountChanged: CrmEventDefinition<z.ZodObject<{
+  opportunityId: z.ZodString;
+  amount: z.ZodNumber;
+  previousAmount: z.ZodOptional<z.ZodNumber>;
+  reason: z.ZodOptional<z.ZodString>;
+  by: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const OpportunityExtended: CrmEventDefinition<z.ZodObject<{
+  opportunityId: z.ZodString;
+  expectedCloseAt: z.ZodISODateTime;
+  previousExpectedCloseAt: z.ZodOptional<z.ZodISODateTime>;
+  reason: z.ZodOptional<z.ZodString>;
+  by: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const PipelineCreated: CrmEventDefinition<z.ZodObject<{
+  pipelineId: z.ZodString;
+}, z.core.$strip>>;
+declare const PipelineArchived: CrmEventDefinition<z.ZodObject<{
+  pipelineId: z.ZodString;
+}, z.core.$strip>>;
+declare const ActivityPlanned: CrmEventDefinition<z.ZodObject<{
+  activityId: z.ZodString;
+  type: z.ZodString;
+  subjectKind: z.ZodString;
+  subjectId: z.ZodString;
+}, z.core.$strip>>;
+declare const ActivityCompleted: CrmEventDefinition<z.ZodObject<{
+  activityId: z.ZodString;
+  completedAt: z.ZodISODateTime;
+}, z.core.$strip>>;
+declare const ActivityCancelled: CrmEventDefinition<z.ZodObject<{
+  activityId: z.ZodString;
+  reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const ActivityRescheduled: CrmEventDefinition<z.ZodObject<{
+  activityId: z.ZodString;
+  dueDate: z.ZodISODateTime;
+  previousDueDate: z.ZodOptional<z.ZodISODateTime>;
+  reason: z.ZodOptional<z.ZodString>;
+  by: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const ActivityOutcomeRecorded: CrmEventDefinition<z.ZodObject<{
+  activityId: z.ZodString;
+  outcome: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>>;
+declare const NoteAdded: CrmEventDefinition<z.ZodObject<{
+  noteId: z.ZodString;
+  subjectKind: z.ZodString;
+  subjectId: z.ZodString;
+}, z.core.$strip>>;
+declare const CampaignCreated: CrmEventDefinition<z.ZodObject<{
+  campaignId: z.ZodString;
+  name: z.ZodString;
+}, z.core.$strip>>;
+declare const CampaignActivated: CrmEventDefinition<z.ZodObject<{
+  campaignId: z.ZodString;
+}, z.core.$strip>>;
+declare const CampaignPaused: CrmEventDefinition<z.ZodObject<{
+  campaignId: z.ZodString;
+  reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const CampaignResumed: CrmEventDefinition<z.ZodObject<{
+  campaignId: z.ZodString;
+}, z.core.$strip>>;
+declare const CampaignCompleted: CrmEventDefinition<z.ZodObject<{
+  campaignId: z.ZodString;
+  actualRevenueAmount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+declare const CampaignArchived: CrmEventDefinition<z.ZodObject<{
+  campaignId: z.ZodString;
+}, z.core.$strip>>;
+declare const SubscriptionCreated: CrmEventDefinition<z.ZodObject<{
+  subscriptionId: z.ZodString;
+  contactId: z.ZodString;
+  campaignId: z.ZodString;
+  requiresConfirmation: z.ZodBoolean;
+}, z.core.$strip>>;
+declare const SubscriptionConfirmed: CrmEventDefinition<z.ZodObject<{
+  subscriptionId: z.ZodString;
+  contactId: z.ZodString;
+  campaignId: z.ZodString;
+  confirmedAt: z.ZodISODateTime;
+}, z.core.$strip>>;
+declare const SubscriptionUnsubscribed: CrmEventDefinition<z.ZodObject<{
+  subscriptionId: z.ZodString;
+  contactId: z.ZodString;
+  campaignId: z.ZodString;
+  reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const SubscriptionBounced: CrmEventDefinition<z.ZodObject<{
+  subscriptionId: z.ZodString;
+  contactId: z.ZodString;
+  campaignId: z.ZodString;
+  reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const SubscriptionComplained: CrmEventDefinition<z.ZodObject<{
+  subscriptionId: z.ZodString;
+  contactId: z.ZodString;
+  campaignId: z.ZodString;
+}, z.core.$strip>>;
+declare const EmailEventOpened: CrmEventDefinition<z.ZodObject<{
+  eventId: z.ZodString;
+  kind: z.ZodString;
+  subjectKind: z.ZodString;
+  subjectId: z.ZodString;
+  campaignId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const EmailEventClicked: CrmEventDefinition<z.ZodObject<{
+  eventId: z.ZodString;
+  kind: z.ZodString;
+  subjectKind: z.ZodString;
+  subjectId: z.ZodString;
+  campaignId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const EmailEventBounced: CrmEventDefinition<z.ZodObject<{
+  eventId: z.ZodString;
+  kind: z.ZodString;
+  subjectKind: z.ZodString;
+  subjectId: z.ZodString;
+  campaignId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const EmailEventComplained: CrmEventDefinition<z.ZodObject<{
+  eventId: z.ZodString;
+  kind: z.ZodString;
+  subjectKind: z.ZodString;
+  subjectId: z.ZodString;
+  campaignId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const EmailEventUnsubscribed: CrmEventDefinition<z.ZodObject<{
+  eventId: z.ZodString;
+  kind: z.ZodString;
+  subjectKind: z.ZodString;
+  subjectId: z.ZodString;
+  campaignId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const ConversationCreated: CrmEventDefinition<z.ZodObject<{
+  conversationId: z.ZodString;
+  channel: z.ZodString;
+  participantKind: z.ZodString;
+  participantId: z.ZodString;
+}, z.core.$strip>>;
+declare const ConversationAssigned: CrmEventDefinition<z.ZodObject<{
+  conversationId: z.ZodString;
+  assigneeId: z.ZodString;
+  previousAssigneeId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const ConversationResolved: CrmEventDefinition<z.ZodObject<{
+  conversationId: z.ZodString;
+  status: z.ZodString;
+  previousStatus: z.ZodString;
+}, z.core.$strip>>;
+declare const ConversationReopened: CrmEventDefinition<z.ZodObject<{
+  conversationId: z.ZodString;
+  status: z.ZodString;
+  previousStatus: z.ZodString;
+}, z.core.$strip>>;
+declare const MessageReceived: CrmEventDefinition<z.ZodObject<{
+  messageId: z.ZodString;
+  conversationId: z.ZodString;
+  direction: z.ZodString;
+  externalMessageId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const MessageSent: CrmEventDefinition<z.ZodObject<{
+  messageId: z.ZodString;
+  conversationId: z.ZodString;
+  direction: z.ZodString;
+  externalMessageId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const crmEventDefinitions: ReadonlyArray<CrmEventDefinition>;
+//#endregion
 //#region src/events/helpers.d.ts
 declare function createEvent<T>(type: string, payload: T, ctx?: CrmContext, meta?: Partial<EventMeta>): DomainEvent<T>;
 //#endregion
@@ -934,11 +1576,11 @@ declare class InProcessCrmBus implements EventTransport {
  * Built on `@classytic/primitives/state-machine` so the same shape lights
  * up across kits (mongokit's `claim()` pairing, sqlitekit follow-ups).
  */
-declare const LEAD_MACHINE: _classytic_primitives_state_machine0.StateMachine<"new" | "contacted" | "qualified" | "converted" | "disqualified" | "nurturing">;
-declare const OPPORTUNITY_MACHINE: _classytic_primitives_state_machine0.StateMachine<"open" | "won" | "lost" | "abandoned">;
-declare const CAMPAIGN_MACHINE: _classytic_primitives_state_machine0.StateMachine<"draft" | "active" | "paused" | "completed" | "archived">;
-declare const SUBSCRIPTION_MACHINE: _classytic_primitives_state_machine0.StateMachine<"pending" | "confirmed" | "unsubscribed" | "bounced" | "complained">;
-declare const ACTIVITY_MACHINE: _classytic_primitives_state_machine0.StateMachine<"completed" | "planned" | "in_progress" | "cancelled">;
+declare const LEAD_MACHINE: _$_classytic_primitives_state_machine0.StateMachine<"new" | "contacted" | "qualified" | "converted" | "disqualified" | "nurturing">;
+declare const OPPORTUNITY_MACHINE: _$_classytic_primitives_state_machine0.StateMachine<"open" | "won" | "lost" | "abandoned">;
+declare const CAMPAIGN_MACHINE: _$_classytic_primitives_state_machine0.StateMachine<"draft" | "active" | "paused" | "completed" | "archived">;
+declare const SUBSCRIPTION_MACHINE: _$_classytic_primitives_state_machine0.StateMachine<"pending" | "confirmed" | "unsubscribed" | "bounced" | "complained">;
+declare const ACTIVITY_MACHINE: _$_classytic_primitives_state_machine0.StateMachine<"completed" | "planned" | "in_progress" | "cancelled">;
 //#endregion
 //#region src/core/errors.d.ts
 /**
@@ -1241,6 +1883,10 @@ declare const createContactSchema: z.ZodObject<{
     personalEmail: z.ZodOptional<z.ZodString>;
     phone: z.ZodOptional<z.ZodString>;
     alternatePhone: z.ZodOptional<z.ZodString>;
+    whatsapp: z.ZodOptional<z.ZodString>;
+    telegram: z.ZodOptional<z.ZodString>;
+    linkedin: z.ZodOptional<z.ZodString>;
+    instagram: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
   jobTitle: z.ZodOptional<z.ZodString>;
   accountId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
@@ -1262,6 +1908,10 @@ declare const updateContactSchema: z.ZodObject<{
     personalEmail: z.ZodOptional<z.ZodString>;
     phone: z.ZodOptional<z.ZodString>;
     alternatePhone: z.ZodOptional<z.ZodString>;
+    whatsapp: z.ZodOptional<z.ZodString>;
+    telegram: z.ZodOptional<z.ZodString>;
+    linkedin: z.ZodOptional<z.ZodString>;
+    instagram: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>>;
   jobTitle: z.ZodOptional<z.ZodOptional<z.ZodString>>;
   accountId: z.ZodOptional<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>>;
@@ -1570,6 +2220,8 @@ declare const emailEventFilterSchema: z.ZodObject<{
   messageId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type RecordEmailEventDto = z.infer<typeof recordEmailEventSchema>;
+declare namespace index_d_exports {
+  export { AddNoteDto, CancelActivityDto, CloseLossDto, CloseWinDto, CompleteCampaignDto, ConfirmSubscriptionDto, ConvertLeadDto, CreateAccountDto, CreateCampaignDto, CreateContactDto, CreateLeadDto, CreateLossReasonDto, CreatePipelineDto, LeadFilterDto, MoveStageDto, OpenOpportunityDto, OpportunityFilterDto, PlanActivityDto, RecordEmailEventDto, StageInputDto, SubscribeDto, UnsubscribeDto, UpdateAccountDto, UpdateCampaignDto, UpdateContactDto, UpdateLeadDto, UpdateLossReasonDto, UpdateNoteDto, UpdatePipelineDto, accountFilterSchema, activityFilterSchema, addNoteSchema, campaignFilterSchema, cancelActivitySchema, closeLossSchema, closeWinSchema, completeCampaignSchema, confirmSubscriptionSchema, contactFilterSchema, convertLeadSchema, createAccountSchema, createCampaignSchema, createContactSchema, createLeadSchema, createLossReasonSchema, createPipelineSchema, currencyCodeSchema, emailEventFilterSchema, leadFilterSchema, lossReasonFilterSchema, metadataSchema, moneyAmountSchema, moveStageSchema, noteFilterSchema, objectIdLike, openOpportunitySchema, opportunityFilterSchema, pipelineFilterSchema, planActivitySchema, recordEmailEventSchema, stageInputSchemaExport, subscribeSchema, subscriptionFilterSchema, tagsSchema, unsubscribeSchema, updateAccountSchema, updateActivitySchema, updateCampaignSchema, updateContactSchema, updateLeadSchema, updateLossReasonSchema, updateNoteSchema, updatePipelineSchema };
+}
 //#endregion
-export { ACTIVITY_MACHINE, ACTIVITY_STATUSES, ACTIVITY_TRANSITIONS, ACTIVITY_TYPES, AccountRepository, AccountRepositoryDeps, ActivityRepository, ActivityRepositoryDeps, type ActivityStatus, type ActivityType, CAMPAIGN_MACHINE, CAMPAIGN_STATUSES, CAMPAIGN_TRANSITIONS, CRM_EVENTS, CampaignRepository, CampaignRepositoryDeps, type CampaignStatus, CloseInput, ContactRepository, ContactRepositoryDeps, ConversionRow, ConvertLeadInput, ConvertResult, CreateCrmRepositoriesDeps, CrmConfig, CrmContext, CrmEngine, CrmError, CrmEventName, CrmLogger, CrmModels, CrmRepositories, DuplicateCampaignError, DuplicateLeadError, DuplicateSubscriptionError, EMAIL_EVENT_KINDS, EMAIL_EVENT_SUBJECT_KINDS, type EmailEventKind, EmailEventRepository, EmailEventRepositoryDeps, EmailEventSubjectKind, EmptyPipelineError, ForecastOptions, ForecastRow, type IAccountDocument, type IActivityDocument, type ICampaignDocument, ICampaignStatusEntry, type IContactDocument, IContactInfoEmbedded, IContactName, type IEmailEventDocument, type ILeadDocument, ILeadStatusEntry, type ILossReasonDocument, type INoteDocument, type IOpportunityDocument, IOpportunityStatusEntry, type IPipelineDocument, IStageDocument, type ISubscriptionDocument, ISubscriptionStatusEntry, InProcessCrmBus, InvalidActivityTransitionError, InvalidCampaignTransitionError, InvalidConfirmationTokenError, InvalidLeadTransitionError, InvalidOpportunityTransitionError, InvalidSubscriptionTransitionError, InvalidUnsubscribeTokenError, LEAD_MACHINE, LEAD_STATUSES, LEAD_TRANSITIONS, LeadAlreadyConvertedError, LeadInput, LeadRepository, LeadRepositoryDeps, LeadScorer, LeadService, LeadServiceDeps, type LeadStatus, LossReasonRepository, LossReasonRepositoryDeps, MoveStageInput, NotFoundError, NoteRepository, NoteRepositoryDeps, OPPORTUNITY_MACHINE, OPPORTUNITY_STATUSES, OPPORTUNITY_TRANSITIONS, OpenOpportunityInput, OpportunityForecast, OpportunityRepository, OpportunityRepositoryDeps, type OpportunityStatus, PipelineRepository, PipelineRepositoryDeps, RecordEmailEventInput, ResolvedCrmConfig, SUBJECT_KINDS, SUBSCRIPTION_MACHINE, SUBSCRIPTION_STATUSES, SUBSCRIPTION_TRANSITIONS, SchemaBuildConfig, StageNotInPipelineError, type StatusChangeEntry, type StatusHistory, type SubjectKind, SubscribeInput, SubscriptionRepository, SubscriptionRepositoryDeps, type SubscriptionStatus, TenantFieldType, _ModelTypes, 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, index_d_exports as validators };
-//# sourceMappingURL=index.d.ts.map
+export { ACTIVITY_MACHINE, ACTIVITY_STATUSES, ACTIVITY_TRANSITIONS, ACTIVITY_TYPES, AccountAssigned, AccountCreated, AccountEnriched, AccountMerged, AccountRepository, AccountRepositoryDeps, AccountUpdated, ActivityCancelled, ActivityCompleted, ActivityOutcomeRecorded, ActivityPlanned, ActivityRepository, ActivityRepositoryDeps, ActivityRescheduled, type ActivityStatus, type ActivityType, CAMPAIGN_MACHINE, CAMPAIGN_STATUSES, CAMPAIGN_TRANSITIONS, CONVERSATION_CHANNELS, CONVERSATION_PARTICIPANT_KINDS, CONVERSATION_STATUSES, CRM_EVENTS, CRM_MODEL_NAMES, CampaignActivated, CampaignArchived, CampaignCompleted, CampaignCreated, CampaignPaused, CampaignRepository, CampaignRepositoryDeps, CampaignResumed, type CampaignStatus, CloseInput, ContactAssigned, ContactCreated, ContactEnriched, ContactMerged, ContactRepository, ContactRepositoryDeps, ContactUpdated, ConversationAssigned, type ConversationChannel, ConversationCreated, type ConversationParticipantKind, ConversationReopened, ConversationRepository, ConversationRepositoryDeps, ConversationResolved, type ConversationStatus, ConversionRow, ConvertLeadInput, ConvertResult, CreateCrmRepositoriesDeps, CreateModelsOptions, CrmConfig, CrmContext, CrmEngine, CrmError, CrmEventDefinition, CrmEventName, CrmEventSchema, CrmLogger, CrmModels, CrmRepositories, DuplicateCampaignError, DuplicateLeadError, DuplicateSubscriptionError, EMAIL_EVENT_KINDS, EMAIL_EVENT_SUBJECT_KINDS, EmailEventBounced, EmailEventClicked, EmailEventComplained, type EmailEventKind, EmailEventOpened, EmailEventRepository, EmailEventRepositoryDeps, EmailEventSubjectKind, EmailEventUnsubscribed, EmptyPipelineError, ForecastOptions, ForecastRow, type IAccountDocument, type IActivityDocument, type ICampaignDocument, ICampaignStatusEntry, type IContactDocument, IContactInfoEmbedded, IContactName, type IConversationDocument, type IEmailEventDocument, type ILeadDocument, ILeadStatusEntry, type ILossReasonDocument, IMessageAttachment, type IMessageDocument, type INoteDocument, type IOpportunityDocument, IOpportunityStatusEntry, type IPipelineDocument, IStageDocument, type ISubscriptionDocument, ISubscriptionStatusEntry, InProcessCrmBus, InvalidActivityTransitionError, InvalidCampaignTransitionError, InvalidConfirmationTokenError, InvalidLeadTransitionError, InvalidOpportunityTransitionError, InvalidSubscriptionTransitionError, InvalidUnsubscribeTokenError, LEAD_MACHINE, LEAD_STATUSES, LEAD_TRANSITIONS, LeadAlreadyConvertedError, LeadAssigned, LeadConverted, LeadCreated, LeadDisqualified, LeadEnriched, LeadInput, LeadRepository, LeadRepositoryDeps, LeadScored, LeadScorer, LeadService, LeadServiceDeps, type LeadStatus, LeadStatusChanged, LossReasonRepository, LossReasonRepositoryDeps, MESSAGE_DELIVERY_STATUSES, MESSAGE_DIRECTIONS, MergeAccountInput, MergeContactInput, type MessageDeliveryStatus, type MessageDirection, MessageReceived, MessageRepository, MessageRepositoryDeps, MessageSent, MoveStageInput, NotFoundError, NoteAdded, NoteRepository, NoteRepositoryDeps, OPPORTUNITY_MACHINE, OPPORTUNITY_STATUSES, OPPORTUNITY_TRANSITIONS, OpenConversationInput, OpenOpportunityInput, OpportunityAbandoned, OpportunityAmountChanged, OpportunityAssigned, OpportunityCreated, OpportunityExtended, OpportunityForecast, OpportunityLost, OpportunityRepository, OpportunityRepositoryDeps, OpportunityStageAdvanced, OpportunityStageRegressed, type OpportunityStatus, OpportunityWon, PipelineArchived, PipelineCreated, PipelineRepository, PipelineRepositoryDeps, RecordEmailEventInput, RecordMessageInput, ResolvedCrmConfig, SUBJECT_KINDS, SUBSCRIPTION_MACHINE, SUBSCRIPTION_STATUSES, SUBSCRIPTION_TRANSITIONS, SchemaBuildConfig, StageNotInPipelineError, type StatusChangeEntry, type StatusHistory, type SubjectKind, SubscribeInput, SubscriptionBounced, SubscriptionComplained, SubscriptionConfirmed, SubscriptionCreated, SubscriptionRepository, SubscriptionRepositoryDeps, type SubscriptionStatus, SubscriptionUnsubscribed, TenantFieldType, _ModelTypes, 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, index_d_exports as validators };