@classytic/crm 0.5.0 → 0.5.1

package/dist/index.js

@@ -1,7 +1,7 @@
-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 { t as __exportAll } from "./chunk.js";
 import { Schema } from "mongoose";
 import { Repository, aggregateHelpersPlugin, isDuplicateKeyError, methodRegistryPlugin, multiTenantPlugin } from "@classytic/mongokit";
+import { createEvent as createEvent$1, matchEventPattern } from "@classytic/primitives/events";
 import { assertAndClaim, defineStateMachine } from "@classytic/primitives/state-machine";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
@@ -1653,6 +1653,86 @@ function createCrmModels(connection, config) {
 	});
 }
 //#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",
+	LEAD_ENRICHED: "crm:lead.enriched",
+	LEAD_ASSIGNED: "crm:lead.assigned",
+	CONTACT_ENRICHED: "crm:contact.enriched",
+	CONTACT_ASSIGNED: "crm:contact.assigned",
+	CONTACT_MERGED: "crm:contact.merged",
+	ACCOUNT_ENRICHED: "crm:account.enriched",
+	ACCOUNT_ASSIGNED: "crm:account.assigned",
+	ACCOUNT_MERGED: "crm:account.merged",
+	OPPORTUNITY_ASSIGNED: "crm:opportunity.assigned",
+	OPPORTUNITY_AMOUNT_CHANGED: "crm:opportunity.amount_changed",
+	OPPORTUNITY_EXTENDED: "crm:opportunity.extended",
+	ACTIVITY_RESCHEDULED: "crm:activity.rescheduled",
+	ACTIVITY_OUTCOME_RECORDED: "crm:activity.outcome_recorded",
+	CONVERSATION_CREATED: "crm:conversation.created",
+	CONVERSATION_ASSIGNED: "crm:conversation.assigned",
+	CONVERSATION_RESOLVED: "crm:conversation.resolved",
+	CONVERSATION_REOPENED: "crm:conversation.reopened",
+	MESSAGE_RECEIVED: "crm:message.received",
+	MESSAGE_SENT: "crm:message.sent"
+};
+//#endregion
+//#region src/events/helpers.ts
+/**
+* Event creation helper.
+*
+* 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.
+*/
+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
+	});
+}
+//#endregion
 //#region src/repositories/pipeline.repository.ts
 var PipelineRepository = class extends Repository {
 	events;
@@ -3170,6 +3250,43 @@ function createCrmRepositories(models, deps) {
 	});
 }
 //#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 = [];
+	}
+};
+//#endregion
 //#region src/engine/ensure-ready.ts
 const REQUIRED_CAPABILITIES = [
 	"upsert",
@@ -3400,6 +3517,602 @@ function splitLeadName(lead) {
 	};
 }
 //#endregion
+//#region src/events/event-catalog.ts
+/**
+* Zod-source event catalog (PACKAGE_RULES rule 18).
+*
+* One Zod schema per event is the source of truth — runtime validation,
+* static types, and Arc introspection all derive from it. Hosts wire the
+* definitions into arc's `EventRegistry`:
+*
+* ```ts
+* for (const def of crmEventDefinitions) registry.register(def);
+* ```
+*
+* which lights up publish-time validation (`eventPlugin({ registry,
+* validateMode: 'reject' })`), OpenAPI event introspection, and
+* `arc describe` output — with zero arc imports here (the definition shape
+* is structurally identical to arc's `EventDefinitionOutput`).
+*
+* Timestamps in payloads are `z.iso.datetime()` (NEVER `z.coerce.date()`):
+* `z.toJSONSchema()` throws on coerce.date, and events are ISO strings on
+* the wire (rule 25).
+*/
+function defineCrmEvent(input) {
+	const { name, resource, description, version = 1, zodSchema } = input;
+	return {
+		name,
+		version,
+		description,
+		zodSchema,
+		schema: z.toJSONSchema(zodSchema),
+		create(payload, meta) {
+			return createEvent$1(name, payload, {
+				resource,
+				source: "crm",
+				...meta
+			});
+		}
+	};
+}
+const ownerChangeSchema = z.object({
+	ownerId: z.string(),
+	previousOwnerId: z.string().optional()
+});
+const enrichSchema = z.object({
+	fields: z.array(z.string()),
+	provider: z.string().optional()
+});
+const mergeSchema = z.object({
+	primaryId: z.string(),
+	secondaryId: z.string(),
+	strategy: z.enum(["preferPrimary", "preferSecondary"])
+});
+const stageRefSchema = z.object({
+	stageId: z.string(),
+	sequence: z.number()
+});
+const LeadCreated = defineCrmEvent({
+	name: CRM_EVENTS.LEAD_CREATED,
+	resource: "lead",
+	description: "createLead() inserted a scored lead.",
+	zodSchema: z.object({
+		leadId: z.string(),
+		email: z.string().optional(),
+		score: z.number()
+	})
+});
+const LeadStatusChanged = defineCrmEvent({
+	name: CRM_EVENTS.LEAD_STATUS_CHANGED,
+	resource: "lead",
+	description: "A lead lifecycle transition committed (qualify/disqualify/nurture/...).",
+	zodSchema: z.object({
+		leadId: z.string(),
+		from: z.string(),
+		to: z.string()
+	})
+});
+const LeadScored = defineCrmEvent({
+	name: CRM_EVENTS.LEAD_SCORED,
+	resource: "lead",
+	description: "A lead score was (re)computed and persisted.",
+	zodSchema: z.object({
+		leadId: z.string(),
+		score: z.number()
+	})
+});
+const LeadConverted = defineCrmEvent({
+	name: CRM_EVENTS.LEAD_CONVERTED,
+	resource: "lead",
+	description: "convert() spawned Contact (+ Account) + Opportunity and closed the lead.",
+	zodSchema: z.object({
+		leadId: z.string(),
+		contactId: z.string(),
+		accountId: z.string().optional(),
+		opportunityId: z.string()
+	})
+});
+const LeadDisqualified = defineCrmEvent({
+	name: CRM_EVENTS.LEAD_DISQUALIFIED,
+	resource: "lead",
+	description: "disqualify() rejected a lead with a reason.",
+	zodSchema: z.object({
+		leadId: z.string(),
+		reason: z.string()
+	})
+});
+const LeadEnriched = defineCrmEvent({
+	name: CRM_EVENTS.LEAD_ENRICHED,
+	resource: "lead",
+	description: "enrich() merged a provider/manual patch into the lead.",
+	zodSchema: z.object({ leadId: z.string() }).extend(enrichSchema.shape)
+});
+const LeadAssigned = defineCrmEvent({
+	name: CRM_EVENTS.LEAD_ASSIGNED,
+	resource: "lead",
+	description: "assign() (re)assigned the lead owner.",
+	zodSchema: z.object({ leadId: z.string() }).extend(ownerChangeSchema.shape)
+});
+const AccountCreated = defineCrmEvent({
+	name: CRM_EVENTS.ACCOUNT_CREATED,
+	resource: "account",
+	description: "createAccount() inserted an account.",
+	zodSchema: z.object({
+		accountId: z.string(),
+		name: z.string()
+	})
+});
+const AccountUpdated = defineCrmEvent({
+	name: CRM_EVENTS.ACCOUNT_UPDATED,
+	resource: "account",
+	description: "An account record was updated.",
+	zodSchema: z.object({ accountId: z.string() })
+});
+const AccountEnriched = defineCrmEvent({
+	name: CRM_EVENTS.ACCOUNT_ENRICHED,
+	resource: "account",
+	description: "enrich() merged a patch into the account.",
+	zodSchema: z.object({ accountId: z.string() }).extend(enrichSchema.shape)
+});
+const AccountAssigned = defineCrmEvent({
+	name: CRM_EVENTS.ACCOUNT_ASSIGNED,
+	resource: "account",
+	description: "assign() (re)assigned the account owner.",
+	zodSchema: z.object({ accountId: z.string() }).extend(ownerChangeSchema.shape)
+});
+const AccountMerged = defineCrmEvent({
+	name: CRM_EVENTS.ACCOUNT_MERGED,
+	resource: "account",
+	description: "merge() folded a secondary account into the primary; secondary deleted.",
+	zodSchema: mergeSchema
+});
+const ContactCreated = defineCrmEvent({
+	name: CRM_EVENTS.CONTACT_CREATED,
+	resource: "contact",
+	description: "createContact() inserted a contact.",
+	zodSchema: z.object({
+		contactId: z.string(),
+		email: z.string().optional()
+	})
+});
+const ContactUpdated = defineCrmEvent({
+	name: CRM_EVENTS.CONTACT_UPDATED,
+	resource: "contact",
+	description: "A contact record was updated.",
+	zodSchema: z.object({ contactId: z.string() })
+});
+const ContactEnriched = defineCrmEvent({
+	name: CRM_EVENTS.CONTACT_ENRICHED,
+	resource: "contact",
+	description: "enrich() merged a patch into the contact.",
+	zodSchema: z.object({ contactId: z.string() }).extend(enrichSchema.shape)
+});
+const ContactAssigned = defineCrmEvent({
+	name: CRM_EVENTS.CONTACT_ASSIGNED,
+	resource: "contact",
+	description: "assign() (re)assigned the contact owner.",
+	zodSchema: z.object({ contactId: z.string() }).extend(ownerChangeSchema.shape)
+});
+const ContactMerged = defineCrmEvent({
+	name: CRM_EVENTS.CONTACT_MERGED,
+	resource: "contact",
+	description: "merge() folded a secondary contact into the primary; secondary deleted.",
+	zodSchema: mergeSchema
+});
+const OpportunityCreated = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_CREATED,
+	resource: "opportunity",
+	description: "openOpportunity() created a deal in a pipeline stage.",
+	zodSchema: z.object({
+		opportunityId: z.string(),
+		pipelineId: z.string(),
+		stageId: z.string()
+	})
+});
+const OpportunityStageAdvanced = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_STAGE_ADVANCED,
+	resource: "opportunity",
+	description: "moveToStage() moved the deal forward (higher stage sequence).",
+	zodSchema: z.object({
+		opportunityId: z.string(),
+		from: stageRefSchema,
+		to: stageRefSchema
+	})
+});
+const OpportunityStageRegressed = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_STAGE_REGRESSED,
+	resource: "opportunity",
+	description: "moveToStage() moved the deal backward (lower stage sequence).",
+	zodSchema: z.object({
+		opportunityId: z.string(),
+		from: stageRefSchema,
+		to: stageRefSchema
+	})
+});
+const OpportunityWon = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_WON,
+	resource: "opportunity",
+	description: "win() closed the deal as won (terminal).",
+	zodSchema: z.object({
+		opportunityId: z.string(),
+		amount: z.number().optional()
+	})
+});
+const OpportunityLost = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_LOST,
+	resource: "opportunity",
+	description: "lose() closed the deal as lost (terminal).",
+	zodSchema: z.object({
+		opportunityId: z.string(),
+		lostReasonId: z.string().optional()
+	})
+});
+const OpportunityAbandoned = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_ABANDONED,
+	resource: "opportunity",
+	description: "abandon() closed the deal as abandoned (terminal).",
+	zodSchema: z.object({ opportunityId: z.string() })
+});
+const OpportunityAssigned = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_ASSIGNED,
+	resource: "opportunity",
+	description: "assign() (re)assigned the opportunity owner.",
+	zodSchema: z.object({ opportunityId: z.string() }).extend(ownerChangeSchema.shape)
+});
+const OpportunityAmountChanged = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_AMOUNT_CHANGED,
+	resource: "opportunity",
+	description: "updateAmount() changed an open deal value.",
+	zodSchema: z.object({
+		opportunityId: z.string(),
+		amount: z.number(),
+		previousAmount: z.number().optional(),
+		reason: z.string().optional(),
+		by: z.string().optional()
+	})
+});
+const OpportunityExtended = defineCrmEvent({
+	name: CRM_EVENTS.OPPORTUNITY_EXTENDED,
+	resource: "opportunity",
+	description: "extendCloseDate() pushed expectedCloseAt further out.",
+	zodSchema: z.object({
+		opportunityId: z.string(),
+		expectedCloseAt: z.iso.datetime(),
+		previousExpectedCloseAt: z.iso.datetime().optional(),
+		reason: z.string().optional(),
+		by: z.string().optional()
+	})
+});
+const PipelineCreated = defineCrmEvent({
+	name: CRM_EVENTS.PIPELINE_CREATED,
+	resource: "pipeline",
+	description: "A pipeline was created.",
+	zodSchema: z.object({ pipelineId: z.string() })
+});
+const PipelineArchived = defineCrmEvent({
+	name: CRM_EVENTS.PIPELINE_ARCHIVED,
+	resource: "pipeline",
+	description: "archive() soft-deprecated a pipeline.",
+	zodSchema: z.object({ pipelineId: z.string() })
+});
+const ActivityPlanned = defineCrmEvent({
+	name: CRM_EVENTS.ACTIVITY_PLANNED,
+	resource: "activity",
+	description: "plan() created a planned activity against a subject.",
+	zodSchema: z.object({
+		activityId: z.string(),
+		type: z.string(),
+		subjectKind: z.string(),
+		subjectId: z.string()
+	})
+});
+const ActivityCompleted = defineCrmEvent({
+	name: CRM_EVENTS.ACTIVITY_COMPLETED,
+	resource: "activity",
+	description: "complete() finished an activity.",
+	zodSchema: z.object({
+		activityId: z.string(),
+		completedAt: z.iso.datetime()
+	})
+});
+const ActivityCancelled = defineCrmEvent({
+	name: CRM_EVENTS.ACTIVITY_CANCELLED,
+	resource: "activity",
+	description: "cancel() cancelled an activity.",
+	zodSchema: z.object({
+		activityId: z.string(),
+		reason: z.string().optional()
+	})
+});
+const ActivityRescheduled = defineCrmEvent({
+	name: CRM_EVENTS.ACTIVITY_RESCHEDULED,
+	resource: "activity",
+	description: "reschedule() moved an activity due date.",
+	zodSchema: z.object({
+		activityId: z.string(),
+		dueDate: z.iso.datetime(),
+		previousDueDate: z.iso.datetime().optional(),
+		reason: z.string().optional(),
+		by: z.string().optional()
+	})
+});
+const ActivityOutcomeRecorded = defineCrmEvent({
+	name: CRM_EVENTS.ACTIVITY_OUTCOME_RECORDED,
+	resource: "activity",
+	description: "recordOutcome() logged an activity outcome (no status change).",
+	zodSchema: z.object({
+		activityId: z.string(),
+		outcome: z.record(z.string(), z.unknown())
+	})
+});
+const NoteAdded = defineCrmEvent({
+	name: CRM_EVENTS.NOTE_ADDED,
+	resource: "note",
+	description: "A note was appended to a subject timeline.",
+	zodSchema: z.object({
+		noteId: z.string(),
+		subjectKind: z.string(),
+		subjectId: z.string()
+	})
+});
+const CampaignCreated = defineCrmEvent({
+	name: CRM_EVENTS.CAMPAIGN_CREATED,
+	resource: "campaign",
+	description: "createCampaign() inserted a campaign.",
+	zodSchema: z.object({
+		campaignId: z.string(),
+		name: z.string()
+	})
+});
+const CampaignActivated = defineCrmEvent({
+	name: CRM_EVENTS.CAMPAIGN_ACTIVATED,
+	resource: "campaign",
+	description: "activate() moved a campaign to active.",
+	zodSchema: z.object({ campaignId: z.string() })
+});
+const CampaignPaused = defineCrmEvent({
+	name: CRM_EVENTS.CAMPAIGN_PAUSED,
+	resource: "campaign",
+	description: "pause() suspended an active campaign.",
+	zodSchema: z.object({
+		campaignId: z.string(),
+		reason: z.string().optional()
+	})
+});
+const CampaignResumed = defineCrmEvent({
+	name: CRM_EVENTS.CAMPAIGN_RESUMED,
+	resource: "campaign",
+	description: "resume() reactivated a paused campaign.",
+	zodSchema: z.object({ campaignId: z.string() })
+});
+const CampaignCompleted = defineCrmEvent({
+	name: CRM_EVENTS.CAMPAIGN_COMPLETED,
+	resource: "campaign",
+	description: "complete() closed a campaign.",
+	zodSchema: z.object({
+		campaignId: z.string(),
+		actualRevenueAmount: z.number().optional()
+	})
+});
+const CampaignArchived = defineCrmEvent({
+	name: CRM_EVENTS.CAMPAIGN_ARCHIVED,
+	resource: "campaign",
+	description: "archive() archived a campaign (terminal).",
+	zodSchema: z.object({ campaignId: z.string() })
+});
+const SubscriptionCreated = defineCrmEvent({
+	name: CRM_EVENTS.SUBSCRIPTION_CREATED,
+	resource: "subscription",
+	description: "subscribe() created an opt-in (pending or confirmed).",
+	zodSchema: z.object({
+		subscriptionId: z.string(),
+		contactId: z.string(),
+		campaignId: z.string(),
+		requiresConfirmation: z.boolean()
+	})
+});
+const SubscriptionConfirmed = defineCrmEvent({
+	name: CRM_EVENTS.SUBSCRIPTION_CONFIRMED,
+	resource: "subscription",
+	description: "confirm() validated a double-opt-in token.",
+	zodSchema: z.object({
+		subscriptionId: z.string(),
+		contactId: z.string(),
+		campaignId: z.string(),
+		confirmedAt: z.iso.datetime()
+	})
+});
+const SubscriptionUnsubscribed = defineCrmEvent({
+	name: CRM_EVENTS.SUBSCRIPTION_UNSUBSCRIBED,
+	resource: "subscription",
+	description: "unsubscribe() opted a contact out (terminal).",
+	zodSchema: z.object({
+		subscriptionId: z.string(),
+		contactId: z.string(),
+		campaignId: z.string(),
+		reason: z.string().optional()
+	})
+});
+const SubscriptionBounced = defineCrmEvent({
+	name: CRM_EVENTS.SUBSCRIPTION_BOUNCED,
+	resource: "subscription",
+	description: "markBounced() recorded a hard bounce (terminal).",
+	zodSchema: z.object({
+		subscriptionId: z.string(),
+		contactId: z.string(),
+		campaignId: z.string(),
+		reason: z.string().optional()
+	})
+});
+const SubscriptionComplained = defineCrmEvent({
+	name: CRM_EVENTS.SUBSCRIPTION_COMPLAINED,
+	resource: "subscription",
+	description: "markComplained() recorded a spam complaint (terminal).",
+	zodSchema: z.object({
+		subscriptionId: z.string(),
+		contactId: z.string(),
+		campaignId: z.string()
+	})
+});
+const emailEventSchema = z.object({
+	eventId: z.string(),
+	kind: z.string(),
+	subjectKind: z.string(),
+	subjectId: z.string(),
+	campaignId: z.string().optional()
+});
+const EmailEventOpened = defineCrmEvent({
+	name: CRM_EVENTS.EMAIL_EVENT_OPENED,
+	resource: "email_event",
+	description: "recordOpen() logged an email open.",
+	zodSchema: emailEventSchema
+});
+const EmailEventClicked = defineCrmEvent({
+	name: CRM_EVENTS.EMAIL_EVENT_CLICKED,
+	resource: "email_event",
+	description: "recordClick() logged a link click.",
+	zodSchema: emailEventSchema
+});
+const EmailEventBounced = defineCrmEvent({
+	name: CRM_EVENTS.EMAIL_EVENT_BOUNCED,
+	resource: "email_event",
+	description: "recordBounce() logged a bounce.",
+	zodSchema: emailEventSchema
+});
+const EmailEventComplained = defineCrmEvent({
+	name: CRM_EVENTS.EMAIL_EVENT_COMPLAINED,
+	resource: "email_event",
+	description: "recordComplaint() logged a spam complaint.",
+	zodSchema: emailEventSchema
+});
+const EmailEventUnsubscribed = defineCrmEvent({
+	name: CRM_EVENTS.EMAIL_EVENT_UNSUBSCRIBED,
+	resource: "email_event",
+	description: "recordUnsubscribe() logged a one-click unsubscribe.",
+	zodSchema: emailEventSchema
+});
+const ConversationCreated = defineCrmEvent({
+	name: CRM_EVENTS.CONVERSATION_CREATED,
+	resource: "conversation",
+	description: "openConversation() started a conversation thread.",
+	zodSchema: z.object({
+		conversationId: z.string(),
+		channel: z.string(),
+		participantKind: z.string(),
+		participantId: z.string()
+	})
+});
+const ConversationAssigned = defineCrmEvent({
+	name: CRM_EVENTS.CONVERSATION_ASSIGNED,
+	resource: "conversation",
+	description: "assign() (re)assigned a conversation owner.",
+	zodSchema: z.object({
+		conversationId: z.string(),
+		assigneeId: z.string(),
+		previousAssigneeId: z.string().optional()
+	})
+});
+const ConversationResolved = defineCrmEvent({
+	name: CRM_EVENTS.CONVERSATION_RESOLVED,
+	resource: "conversation",
+	description: "resolve() closed a conversation.",
+	zodSchema: z.object({
+		conversationId: z.string(),
+		status: z.string(),
+		previousStatus: z.string()
+	})
+});
+const ConversationReopened = defineCrmEvent({
+	name: CRM_EVENTS.CONVERSATION_REOPENED,
+	resource: "conversation",
+	description: "reopen() reopened a resolved conversation.",
+	zodSchema: z.object({
+		conversationId: z.string(),
+		status: z.string(),
+		previousStatus: z.string()
+	})
+});
+const MessageReceived = defineCrmEvent({
+	name: CRM_EVENTS.MESSAGE_RECEIVED,
+	resource: "message",
+	description: "recordInbound() logged an inbound message.",
+	zodSchema: z.object({
+		messageId: z.string(),
+		conversationId: z.string(),
+		direction: z.string(),
+		externalMessageId: z.string().optional()
+	})
+});
+const MessageSent = defineCrmEvent({
+	name: CRM_EVENTS.MESSAGE_SENT,
+	resource: "message",
+	description: "recordOutbound() logged an outbound message.",
+	zodSchema: z.object({
+		messageId: z.string(),
+		conversationId: z.string(),
+		direction: z.string(),
+		externalMessageId: z.string().optional()
+	})
+});
+const crmEventDefinitions = [
+	LeadCreated,
+	LeadStatusChanged,
+	LeadScored,
+	LeadConverted,
+	LeadDisqualified,
+	LeadEnriched,
+	LeadAssigned,
+	AccountCreated,
+	AccountUpdated,
+	AccountEnriched,
+	AccountAssigned,
+	AccountMerged,
+	ContactCreated,
+	ContactUpdated,
+	ContactEnriched,
+	ContactAssigned,
+	ContactMerged,
+	OpportunityCreated,
+	OpportunityStageAdvanced,
+	OpportunityStageRegressed,
+	OpportunityWon,
+	OpportunityLost,
+	OpportunityAbandoned,
+	OpportunityAssigned,
+	OpportunityAmountChanged,
+	OpportunityExtended,
+	PipelineCreated,
+	PipelineArchived,
+	ActivityPlanned,
+	ActivityCompleted,
+	ActivityCancelled,
+	ActivityRescheduled,
+	ActivityOutcomeRecorded,
+	NoteAdded,
+	CampaignCreated,
+	CampaignActivated,
+	CampaignPaused,
+	CampaignResumed,
+	CampaignCompleted,
+	CampaignArchived,
+	SubscriptionCreated,
+	SubscriptionConfirmed,
+	SubscriptionUnsubscribed,
+	SubscriptionBounced,
+	SubscriptionComplained,
+	EmailEventOpened,
+	EmailEventClicked,
+	EmailEventBounced,
+	EmailEventComplained,
+	EmailEventUnsubscribed,
+	ConversationCreated,
+	ConversationAssigned,
+	ConversationResolved,
+	ConversationReopened,
+	MessageReceived,
+	MessageSent
+];
+//#endregion
 //#region src/shared/calculators/forecast.ts
 /**
 * Aggregate opportunities into a forecast table — one row per bucket.