@classytic/crm 0.5.0 → 0.7.0

package/dist/events.js

@@ -1,5 +1,5 @@
-import { createEvent as createEvent$1, matchEventPattern } from "@classytic/primitives/events";
 import { z } from "zod";
+import { createEvent as createEvent$1, matchEventPattern } from "@classytic/primitives/events";
 //#region src/events/event-constants.ts
 /** PACKAGE_RULES rule 12: `package:resource.verb`. */
 const CRM_EVENTS = {
@@ -35,6 +35,16 @@ const CRM_EVENTS = {
 	SUBSCRIPTION_UNSUBSCRIBED: "crm:subscription.unsubscribed",
 	SUBSCRIPTION_BOUNCED: "crm:subscription.bounced",
 	SUBSCRIPTION_COMPLAINED: "crm:subscription.complained",
+	SEQUENCE_CREATED: "crm:sequence.created",
+	SEQUENCE_ACTIVATED: "crm:sequence.active",
+	SEQUENCE_PAUSED: "crm:sequence.paused",
+	SEQUENCE_ARCHIVED: "crm:sequence.archived",
+	ENROLLMENT_CREATED: "crm:enrollment.created",
+	ENROLLMENT_STEP_SENT: "crm:enrollment.step_sent",
+	ENROLLMENT_PAUSED: "crm:enrollment.paused",
+	ENROLLMENT_RESUMED: "crm:enrollment.resumed",
+	ENROLLMENT_COMPLETED: "crm:enrollment.completed",
+	ENROLLMENT_EXITED: "crm:enrollment.exited",
 	EMAIL_EVENT_OPENED: "crm:email_event.opened",
 	EMAIL_EVENT_CLICKED: "crm:email_event.clicked",
 	EMAIL_EVENT_BOUNCED: "crm:email_event.bounced",
@@ -53,6 +63,8 @@ const CRM_EVENTS = {
 	OPPORTUNITY_EXTENDED: "crm:opportunity.extended",
 	ACTIVITY_RESCHEDULED: "crm:activity.rescheduled",
 	ACTIVITY_OUTCOME_RECORDED: "crm:activity.outcome_recorded",
+	SUPPRESSION_ADDED: "crm:suppression.added",
+	SUPPRESSION_REMOVED: "crm:suppression.removed",
 	CONVERSATION_CREATED: "crm:conversation.created",
 	CONVERSATION_ASSIGNED: "crm:conversation.assigned",
 	CONVERSATION_RESOLVED: "crm:conversation.resolved",
@@ -60,62 +72,11 @@ const CRM_EVENTS = {
 	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/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 = [];
-	}
-};
+const SUPPRESSION_REASONS = [...[
+	"bounce",
+	"complaint",
+	"unsubscribe"
+], "manual"];
 //#endregion
 //#region src/events/event-catalog.ts
 /**
@@ -554,6 +515,22 @@ const SubscriptionComplained = defineCrmEvent({
 		campaignId: z.string()
 	})
 });
+const SuppressionAdded = defineCrmEvent({
+	name: CRM_EVENTS.SUPPRESSION_ADDED,
+	resource: "suppression",
+	description: "suppress() inserted a NEW row on the org-wide suppression list (idempotent re-suppress of an existing email emits nothing). organizationId rides event meta.",
+	zodSchema: z.object({
+		email: z.string(),
+		reason: z.enum(SUPPRESSION_REASONS),
+		source: z.string().optional()
+	})
+});
+const SuppressionRemoved = defineCrmEvent({
+	name: CRM_EVENTS.SUPPRESSION_REMOVED,
+	resource: "suppression",
+	description: "unsuppress() removed an email from the org-wide suppression list.",
+	zodSchema: z.object({ email: z.string() })
+});
 const emailEventSchema = z.object({
 	eventId: z.string(),
 	kind: z.string(),
@@ -654,6 +631,82 @@ const MessageSent = defineCrmEvent({
 		externalMessageId: z.string().optional()
 	})
 });
+const SequenceCreated = defineCrmEvent({
+	name: CRM_EVENTS.SEQUENCE_CREATED,
+	resource: "sequence",
+	description: "A sequence draft was created. Emitted by the HOST after repo.create() (the package ships no createSequence verb) — defined here so registries validate the payload.",
+	zodSchema: z.object({
+		sequenceId: z.string(),
+		name: z.string().optional()
+	})
+});
+const SequenceActivated = defineCrmEvent({
+	name: CRM_EVENTS.SEQUENCE_ACTIVATED,
+	resource: "sequence",
+	description: "activate() moved a sequence draft/paused → active.",
+	zodSchema: z.object({ sequenceId: z.string() })
+});
+const SequencePaused = defineCrmEvent({
+	name: CRM_EVENTS.SEQUENCE_PAUSED,
+	resource: "sequence",
+	description: "pause() suspended an active sequence (existing enrollments hold).",
+	zodSchema: z.object({ sequenceId: z.string() })
+});
+const SequenceArchived = defineCrmEvent({
+	name: CRM_EVENTS.SEQUENCE_ARCHIVED,
+	resource: "sequence",
+	description: "archive() retired a sequence — no new enrollments.",
+	zodSchema: z.object({ sequenceId: z.string() })
+});
+const EnrollmentCreated = defineCrmEvent({
+	name: CRM_EVENTS.ENROLLMENT_CREATED,
+	resource: "enrollment",
+	description: "enroll() attached a subject to a sequence.",
+	zodSchema: z.object({
+		enrollmentId: z.string(),
+		sequenceId: z.string(),
+		subjectId: z.string(),
+		subjectKind: z.string()
+	})
+});
+const EnrollmentStepSent = defineCrmEvent({
+	name: CRM_EVENTS.ENROLLMENT_STEP_SENT,
+	resource: "enrollment",
+	description: "A sequence step was delivered. Emitted by the HOST outreach layer after its send adapter succeeds + advanceStep() commits (Buffer-style pattern in CLAUDE.md) — defined here so registries validate the payload.",
+	zodSchema: z.object({
+		enrollmentId: z.string(),
+		sequenceId: z.string().optional(),
+		stepIndex: z.number(),
+		channel: z.string().optional()
+	})
+});
+const EnrollmentPaused = defineCrmEvent({
+	name: CRM_EVENTS.ENROLLMENT_PAUSED,
+	resource: "enrollment",
+	description: "pause() held an active enrollment.",
+	zodSchema: z.object({ enrollmentId: z.string() })
+});
+const EnrollmentResumed = defineCrmEvent({
+	name: CRM_EVENTS.ENROLLMENT_RESUMED,
+	resource: "enrollment",
+	description: "resume() reactivated a paused enrollment.",
+	zodSchema: z.object({ enrollmentId: z.string() })
+});
+const EnrollmentCompleted = defineCrmEvent({
+	name: CRM_EVENTS.ENROLLMENT_COMPLETED,
+	resource: "enrollment",
+	description: "complete() finished the final step of an enrollment.",
+	zodSchema: z.object({ enrollmentId: z.string() })
+});
+const EnrollmentExited = defineCrmEvent({
+	name: CRM_EVENTS.ENROLLMENT_EXITED,
+	resource: "enrollment",
+	description: "exit() removed a subject before completion (reply/unsubscribe/manual/goal).",
+	zodSchema: z.object({
+		enrollmentId: z.string(),
+		exitReason: z.string().optional()
+	})
+});
 const crmEventDefinitions = [
 	LeadCreated,
 	LeadStatusChanged,
@@ -700,6 +753,8 @@ const crmEventDefinitions = [
 	SubscriptionUnsubscribed,
 	SubscriptionBounced,
 	SubscriptionComplained,
+	SuppressionAdded,
+	SuppressionRemoved,
 	EmailEventOpened,
 	EmailEventClicked,
 	EmailEventBounced,
@@ -710,7 +765,73 @@ const crmEventDefinitions = [
 	ConversationResolved,
 	ConversationReopened,
 	MessageReceived,
-	MessageSent
+	MessageSent,
+	SequenceCreated,
+	SequenceActivated,
+	SequencePaused,
+	SequenceArchived,
+	EnrollmentCreated,
+	EnrollmentStepSent,
+	EnrollmentPaused,
+	EnrollmentResumed,
+	EnrollmentCompleted,
+	EnrollmentExited
 ];
 //#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, 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 };
+//#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/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
+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, 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 };