@novahelm/engagement

Audience engagement layer for NovaHelm — email/push subscriptions, audience personas, content recommendations, view tracking, and subscriber management.

Status: This package is planned but not yet implemented. The API below reflects the intended design from the NovaHelm roadmap.

Quick Start

pnpm add @novahelm/engagement

import { createEngagementProvider } from "@novahelm/engagement";

const engagement = createEngagementProvider({
  db,
  redis,
  ai,   // for AI-powered recommendations
  email, // for subscription notifications
});

Planned Features

| Feature | Description | |---------|-------------| | Subscriptions | Email and push notification subscriptions with double opt-in | | Personas | AI-generated audience segments based on behavior patterns | | Recommendations | Content recommendations using collaborative filtering and embeddings | | View Tracking | Track content views for popularity and trending calculations | | Campaigns | Email drip campaigns with scheduling and A/B testing | | Subscriber Management | Import/export, tagging, list management |

Intended Client Hooks

// From @novahelm/engagement/client (planned)
import {
  useSubscription,
  useTrackView,
  useRecommendations,
  useRelatedContent,
  SubscribeButton,
  RecommendationFeed,
  RelatedContentSidebar,
} from "@novahelm/engagement/client";

Related

• Dependencies: @novahelm/core, @novahelm/db, @novahelm/ai, @novahelm/jobs, @novahelm/email
• Admin collections: packages/admin-kit/src/collections/engagement.ts
• Layer: 4.5 (Phase 2)