@classytic/crm 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -2,6 +2,130 @@
 
 All notable changes to `@classytic/crm` are documented here.
 
+## [0.7.0] — 2026-07-05
+
+### Added — org-wide email suppression list
+
+- **`Suppression` entity** (`crm.repositories.suppression`, model
+  `Suppression`): global per-org "never email this address again" list —
+  the gate hosts consult before EVERY outbound email. Unsubscribes on
+  `Subscription` stay per-campaign; suppression is org-wide.
+  - `suppress(email, { reason, source?, subjectKind?, subjectId?, metadata? }, ctx?)`
+    — idempotent `getOrCreate` on the unique `(organizationId, email)`
+    index (no check-then-save); emits `crm:suppression.added` only when
+    THIS call inserted the row.
+  - `isSuppressed(email, ctx?)` → boolean.
+  - `filterSuppressed(emails, ctx?)` → `Set<string>` of the suppressed
+    subset — ONE `$in` query for the campaign-fanout hot path.
+  - `unsuppress(email, ctx?)` — atomic delete; emits
+    `crm:suppression.removed` only when a row was actually removed.
+  - All verbs normalize emails (trim + lowercase; schema stores lowercase).
+- **`SUPPRESSION_REASONS`** (`'bounce' | 'complaint' | 'unsubscribe' |
+  'manual'`) — the first three `satisfies readonly EmailEventKind[]` (P6),
+  so a rename in `EMAIL_EVENT_KINDS` fails compilation here.
+- **Events** `crm:suppression.added` / `crm:suppression.removed` — Zod
+  catalog definitions included (no-drift invariant stays green);
+  `organizationId` rides event meta as usual.
+- **Validators** `suppressSchema` / `unsuppressSchema` /
+  `suppressionFilterSchema`.
+
+### Added — reply-detection exit verb
+
+- **`EnrollmentRepository.exitActiveOnReply(subjects, ctx?)`** — the ONE
+  method a host's `crm:message.received` subscriber calls: finds ACTIVE
+  enrollments for the given `{ subjectKind, subjectId }` list, batch-loads
+  their sequences in a single `$in` query, skips those with
+  `replyDetectionEnabled === false`, and exits the rest via `exit(id,
+  'reply')` (each exit emits `crm:enrollment.exited`). Lost CAS races
+  (concurrent pause/complete/exit) are skipped, not failed. Returns the
+  enrollments this call exited.
+- `EnrollmentRepositoryDeps` now carries `sequences: SequenceRepository`
+  (same cross-repo deps idiom as `OpportunityRepository.pipelines` /
+  `MessageRepository.conversations`) — wired automatically by
+  `createCrm()`; only hosts constructing `EnrollmentRepository` by hand
+  need to pass it.
+
+## [0.6.0] — 2026-07-02
+
+Breaking-in-behavior release (ships as MINOR per house convention):
+outbox-first, session-safe event dispatch — the previously deferred
+PACKAGE_RULES §P8/§P8.1 work.
+
+### Added — unit-of-work contract (P8.1, shared with refit/review/cart/invoice)
+
+- **`engine.withTransaction(ctx, body)`** — runs `body` inside a MongoDB
+  transaction with post-commit event discipline: events dispatched through
+  `txCtx` are queued under `ctx[PENDING_EVENTS]` and flushed to the
+  transport only AFTER commit; the queue resets on retry attempts; an abort
+  leaks nothing to in-process subscribers. Reuses the caller's session (and
+  queue) when `ctx.session` is already set. Standalone-Mongo dev boots opt
+  in via the existing `allowNonTransactional: true`.
+- **`PENDING_EVENTS`** (`Symbol.for('@classytic/crm:pendingEvents')`) +
+  **`flushPending(transport, queue, logger?)`** + **`runUnit`** exported
+  from the root for hosts composing their own outer transaction.
+- **`CrmConfig.outbox?: OutboxStore`** (from `@classytic/primitives/outbox`)
+  — when wired, every domain event is persisted via
+  `outbox.save(event, { session })` in the SAME session as the business
+  write; the host's relay publishes committed rows. Outbox save failures
+  PROPAGATE (P8: a swallowed save means the write persists while its event
+  vanishes).
+- **`CrmEventDispatcher`** — EventTransport-compatible wrapper repositories
+  route every event through (`engine.events` is now this wrapper; the host
+  `publish`/`subscribe` surface is unchanged).
+- **`UnmanagedSessionError`** (`code: 'UNMANAGED_SESSION'`) — a host-owned
+  `ctx.session` arriving with neither an outbox nor a `PENDING_EVENTS`
+  queue now throws instead of ghost-publishing mid-transaction.
+  **Behavioral break:** callers that previously threaded a bare session and
+  tolerated ghost events must switch to `engine.withTransaction` (or wire
+  an outbox / attach a queue).
+
+### Added — timezone-aware forecasting
+
+- **`ForecastOptions.timeZone`** — IANA zone for the default month bucket
+  (e.g. `'Asia/Dhaka'`). Without it, months cut at UTC boundaries: a deal
+  expected to close July 1, 02:00 Dhaka time (June 30, 20:00 UTC) files
+  under JUNE. Uses `civilDateOf` from `@classytic/primitives/timezone`.
+  Peer floor bumped: `@classytic/primitives >=0.9.0`.
+
+### Fixed — sequence/enrollment (completes the 0.6.0 WIP)
+
+- **Event catalog no-drift restored**: 10 missing Zod definitions added
+  (`crm:sequence.{created,active,paused,archived}`,
+  `crm:enrollment.{created,step_sent,paused,resumed,completed,exited}`) —
+  `crm:sequence.created` and `crm:enrollment.step_sent` are host-emitted
+  (create via `def.create()`), the rest publish in-repo.
+- **`EnrollmentRepository.setWorkflowRunId` / `advanceStep` no longer
+  bypass the repository**: both used raw `model.findOneAndUpdate` with a
+  manual tenant filter — escaping `multiTenantPlugin` scoping AND
+  `ctx.session` (a call inside `withTransaction` would commit outside the
+  transaction). `advanceStep` is now a `claim()` CAS on `currentStepIndex`
+  with `where: { status: 'active' }`; `setWorkflowRunId` goes through
+  `repo.update`.
+
+### Tests
+
+- 14 new: `tests/unit/dispatch.test.ts` (6 — outbox propagation/session
+  routing/guard/swallow), `tests/integration/unit-of-work.test.ts` (3 —
+  convert() on a replica set: zero mid-tx events, post-commit flush, abort
+  leaks nothing, bare-session guard), `tests/unit/forecast-timezone.test.ts`
+  (5 — the +06:00 month-boundary trap). 110/110 total.
+
+## [0.5.1] — 2026-06-14
+
+### Fixed — declaration bundle
+
+- **fix: declaration bundle exported mangled aliases; consumer named imports
+  now resolve.** The published `dist/index.d.ts` re-exported every public
+  symbol under a minified alias (`export { AccountRepository as A, CRM_EVENTS
+  as Rr, … }`), so downstream `import { AccountRepository, CRM_EVENTS } from
+  '@classytic/crm'` failed with TS2305 / TS2460. Root cause: the `./events`
+  entry re-exports a strict subset of the `index` barrel, which made
+  `rolldown-plugin-dts` alias every name on the superset (`index`) entry when
+  both were emitted in a single pass. Build now runs `index` and `events` as
+  two independent tsdown passes (array config) so each `.d.ts` exports real
+  names. `tsdown` bumped `^0.14.2` → `^0.21.10` to match sibling packages.
+  No runtime/API change.
+
 ## [0.5.0] — 2026-06-14
 
 Stack upgrade + verified correctness fixes + PACKAGE_RULES compliance. No

package/dist/events.d.ts

@@ -1,2 +1,475 @@
-import { $n as ContactUpdated, Ar as PipelineArchived, Bn as ActivityOutcomeRecorded, Cr as OpportunityAssigned, Dr as OpportunityStageAdvanced, Er as OpportunityLost, Fn as AccountEnriched, Fr as SubscriptionCreated, Gn as CampaignCompleted, Hn as ActivityRescheduled, In as AccountMerged, Ir as SubscriptionUnsubscribed, Jn as CampaignResumed, Kn as CampaignCreated, Ln as AccountUpdated, Lr as crmEventDefinitions, Mr as SubscriptionBounced, Nn as AccountAssigned, Nr as SubscriptionComplained, Or as OpportunityStageRegressed, Pn as AccountCreated, Pr as SubscriptionConfirmed, Qn as ContactMerged, Rn as ActivityCancelled, Rr as CRM_EVENTS, Sr as OpportunityAmountChanged, Tr as OpportunityExtended, Un as CampaignActivated, Vn as ActivityPlanned, Wn as CampaignArchived, Xn as ContactCreated, Yn as ContactAssigned, Zn as ContactEnriched, _r as LeadStatusChanged, ar as CrmEventSchema, br as NoteAdded, cr as EmailEventComplained, dr as LeadAssigned, er as ConversationAssigned, fr as LeadConverted, gr as LeadScored, hr as LeadEnriched, ir as CrmEventDefinition, jr as PipelineCreated, kr as OpportunityWon, lr as EmailEventOpened, mr as LeadDisqualified, n as createEvent, nr as ConversationReopened, or as EmailEventBounced, pr as LeadCreated, qn as CampaignPaused, rr as ConversationResolved, sr as EmailEventClicked, t as InProcessCrmBus, tr as ConversationCreated, ur as EmailEventUnsubscribed, vr as MessageReceived, wr as OpportunityCreated, xr as OpportunityAbandoned, yr as MessageSent, zn as ActivityCompleted, zr as CrmEventName } from "./index.js";
-export { 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, CrmEventDefinition, CrmEventName, CrmEventSchema, 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 };
+import { z } from "zod";
+import { DomainEvent, EventHandler, EventMeta, EventTransport } from "@classytic/primitives/events";
+import * as _$mongoose from "mongoose";
+import { OperationContext } from "@classytic/primitives/context";
+//#region src/events/event-constants.d.ts
+/** PACKAGE_RULES rule 12: `package:resource.verb`. */
+declare const CRM_EVENTS: {
+  readonly LEAD_CREATED: "crm:lead.created";
+  readonly LEAD_STATUS_CHANGED: "crm:lead.status_changed";
+  readonly LEAD_SCORED: "crm:lead.scored";
+  readonly LEAD_CONVERTED: "crm:lead.converted";
+  readonly LEAD_DISQUALIFIED: "crm:lead.disqualified";
+  readonly ACCOUNT_CREATED: "crm:account.created";
+  readonly ACCOUNT_UPDATED: "crm:account.updated";
+  readonly CONTACT_CREATED: "crm:contact.created";
+  readonly CONTACT_UPDATED: "crm:contact.updated";
+  readonly OPPORTUNITY_CREATED: "crm:opportunity.created";
+  readonly OPPORTUNITY_STAGE_ADVANCED: "crm:opportunity.stage_advanced";
+  readonly OPPORTUNITY_STAGE_REGRESSED: "crm:opportunity.stage_regressed";
+  readonly OPPORTUNITY_WON: "crm:opportunity.won";
+  readonly OPPORTUNITY_LOST: "crm:opportunity.lost";
+  readonly OPPORTUNITY_ABANDONED: "crm:opportunity.abandoned";
+  readonly PIPELINE_CREATED: "crm:pipeline.created";
+  readonly PIPELINE_ARCHIVED: "crm:pipeline.archived";
+  readonly ACTIVITY_PLANNED: "crm:activity.planned";
+  readonly ACTIVITY_COMPLETED: "crm:activity.completed";
+  readonly ACTIVITY_CANCELLED: "crm:activity.cancelled";
+  readonly NOTE_ADDED: "crm:note.added";
+  readonly CAMPAIGN_CREATED: "crm:campaign.created";
+  readonly CAMPAIGN_ACTIVATED: "crm:campaign.activated";
+  readonly CAMPAIGN_PAUSED: "crm:campaign.paused";
+  readonly CAMPAIGN_RESUMED: "crm:campaign.resumed";
+  readonly CAMPAIGN_COMPLETED: "crm:campaign.completed";
+  readonly CAMPAIGN_ARCHIVED: "crm:campaign.archived";
+  readonly SUBSCRIPTION_CREATED: "crm:subscription.created";
+  readonly SUBSCRIPTION_CONFIRMED: "crm:subscription.confirmed";
+  readonly SUBSCRIPTION_UNSUBSCRIBED: "crm:subscription.unsubscribed";
+  readonly SUBSCRIPTION_BOUNCED: "crm:subscription.bounced";
+  readonly SUBSCRIPTION_COMPLAINED: "crm:subscription.complained";
+  readonly SEQUENCE_CREATED: "crm:sequence.created";
+  readonly SEQUENCE_ACTIVATED: "crm:sequence.active";
+  readonly SEQUENCE_PAUSED: "crm:sequence.paused";
+  readonly SEQUENCE_ARCHIVED: "crm:sequence.archived";
+  readonly ENROLLMENT_CREATED: "crm:enrollment.created";
+  readonly ENROLLMENT_STEP_SENT: "crm:enrollment.step_sent";
+  readonly ENROLLMENT_PAUSED: "crm:enrollment.paused";
+  readonly ENROLLMENT_RESUMED: "crm:enrollment.resumed";
+  readonly ENROLLMENT_COMPLETED: "crm:enrollment.completed";
+  readonly ENROLLMENT_EXITED: "crm:enrollment.exited";
+  readonly EMAIL_EVENT_OPENED: "crm:email_event.opened";
+  readonly EMAIL_EVENT_CLICKED: "crm:email_event.clicked";
+  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 SUPPRESSION_ADDED: "crm:suppression.added";
+  readonly SUPPRESSION_REMOVED: "crm:suppression.removed";
+  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 SuppressionAdded: CrmEventDefinition<z.ZodObject<{
+  email: z.ZodString;
+  reason: z.ZodEnum<{
+    bounce: "bounce";
+    complaint: "complaint";
+    unsubscribe: "unsubscribe";
+    manual: "manual";
+  }>;
+  source: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const SuppressionRemoved: CrmEventDefinition<z.ZodObject<{
+  email: 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 SequenceCreated: CrmEventDefinition<z.ZodObject<{
+  sequenceId: z.ZodString;
+  name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const SequenceActivated: CrmEventDefinition<z.ZodObject<{
+  sequenceId: z.ZodString;
+}, z.core.$strip>>;
+declare const SequencePaused: CrmEventDefinition<z.ZodObject<{
+  sequenceId: z.ZodString;
+}, z.core.$strip>>;
+declare const SequenceArchived: CrmEventDefinition<z.ZodObject<{
+  sequenceId: z.ZodString;
+}, z.core.$strip>>;
+declare const EnrollmentCreated: CrmEventDefinition<z.ZodObject<{
+  enrollmentId: z.ZodString;
+  sequenceId: z.ZodString;
+  subjectId: z.ZodString;
+  subjectKind: z.ZodString;
+}, z.core.$strip>>;
+declare const EnrollmentStepSent: CrmEventDefinition<z.ZodObject<{
+  enrollmentId: z.ZodString;
+  sequenceId: z.ZodOptional<z.ZodString>;
+  stepIndex: z.ZodNumber;
+  channel: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const EnrollmentPaused: CrmEventDefinition<z.ZodObject<{
+  enrollmentId: z.ZodString;
+}, z.core.$strip>>;
+declare const EnrollmentResumed: CrmEventDefinition<z.ZodObject<{
+  enrollmentId: z.ZodString;
+}, z.core.$strip>>;
+declare const EnrollmentCompleted: CrmEventDefinition<z.ZodObject<{
+  enrollmentId: z.ZodString;
+}, z.core.$strip>>;
+declare const EnrollmentExited: CrmEventDefinition<z.ZodObject<{
+  enrollmentId: z.ZodString;
+  exitReason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const crmEventDefinitions: ReadonlyArray<CrmEventDefinition>;
+//#endregion
+//#region src/engine/engine-types.d.ts
+interface CrmLogger {
+  info?(msg: string, meta?: Record<string, unknown>): void;
+  warn?(msg: string, meta?: Record<string, unknown>): void;
+  error?(msg: string, meta?: Record<string, unknown>): void;
+  debug?(msg: string, meta?: Record<string, unknown>): void;
+}
+/**
+ * Operation context threaded through every domain verb. Extends
+ * primitives' `OperationContext` and narrows `IdLike` to types Mongoose
+ * stores cleanly. Host-specific extras go through the inherited
+ * `metadata?` field — keep the typed surface tight.
+ */
+interface CrmContext extends OperationContext {
+  organizationId?: string | _$mongoose.Types.ObjectId;
+  actorId?: string | _$mongoose.Types.ObjectId;
+  /** Mongo transaction session (passed through to mongokit). */
+  session?: unknown;
+}
+//#endregion
+//#region src/events/helpers.d.ts
+declare function createEvent<T>(type: string, payload: T, ctx?: CrmContext, meta?: Partial<EventMeta>): DomainEvent<T>;
+//#endregion
+//#region src/events/in-process-bus.d.ts
+declare class InProcessCrmBus implements EventTransport {
+  readonly name = "in-process-crm";
+  private subs;
+  private logger?;
+  constructor(options?: {
+    logger?: CrmLogger;
+  });
+  publish(event: DomainEvent): Promise<void>;
+  subscribe(pattern: string, handler: EventHandler): Promise<() => void>;
+  close(): Promise<void>;
+}
+//#endregion
+export { 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, CrmEventDefinition, CrmEventName, CrmEventSchema, EmailEventBounced, EmailEventClicked, EmailEventComplained, EmailEventOpened, EmailEventUnsubscribed, EnrollmentCompleted, EnrollmentCreated, EnrollmentExited, EnrollmentPaused, EnrollmentResumed, EnrollmentStepSent, InProcessCrmBus, LeadAssigned, LeadConverted, LeadCreated, LeadDisqualified, LeadEnriched, LeadScored, LeadStatusChanged, MessageReceived, MessageSent, NoteAdded, OpportunityAbandoned, OpportunityAmountChanged, OpportunityAssigned, OpportunityCreated, OpportunityExtended, OpportunityLost, OpportunityStageAdvanced, OpportunityStageRegressed, OpportunityWon, PipelineArchived, PipelineCreated, SequenceActivated, SequenceArchived, SequenceCreated, SequencePaused, SubscriptionBounced, SubscriptionComplained, SubscriptionConfirmed, SubscriptionCreated, SubscriptionUnsubscribed, SuppressionAdded, SuppressionRemoved, createEvent, crmEventDefinitions };