autotel-subscribers

name	autotel-subscribers
description	Event subscribers for autotel. PostHog, Mixpanel, Amplitude, Segment, Webhook, Slack. Configure in init() subscribers; use track() or Event from autotel. Import from autotel-subscribers/posthog etc.

autotel-subscribers

Event subscribers send product/analytics events from autotel to external platforms. Configure subscribers in init(); then use track() or Event from autotel. Each adapter is a separate import path for tree-shaking.

Setup

import { init, track } from 'autotel';
import { PostHogSubscriber } from 'autotel-subscribers/posthog';

init({
  service: 'my-app',
  subscribers: [new PostHogSubscriber({ apiKey: 'phc_...' })],
});

track('order.completed', { userId: 'user-123', amount: 99.99 });

Subscribers and import paths

Platform	Import path	Peer dependency
PostHog	autotel-subscribers/posthog	posthog-node (optional)
Mixpanel	autotel-subscribers/mixpanel	mixpanel (optional)
Amplitude	autotel-subscribers/amplitude	@amplitude/analytics-node
Segment	autotel-subscribers/segment	@segment/analytics-node
Webhook	autotel-subscribers/webhook	none
Slack	autotel-subscribers/slack	none

Install the peer dependency for the subscriber you use (e.g. pnpm add posthog-node for PostHog).

Core patterns

Multiple subscribers: Pass an array to init({ subscribers: [new PostHogSubscriber(...), new MixpanelSubscriber(...)] }). Events are sent to all.

Event instance with overrides: Use Event from autotel/event with a custom subscribers option to send only to specific backends for that instance.

Factories: autotel-subscribers/factories provides createPostHogSubscriber() etc. for env-based config.

Common mistakes

HIGH Import from "autotel-subscribers" instead of the adapter path

Wrong:

import { PostHogSubscriber } from 'autotel-subscribers';

Correct:

import { PostHogSubscriber } from 'autotel-subscribers/posthog';

Each adapter is a separate export; use the subpath so only the adapter you use is bundled.

Source: packages/autotel-subscribers/package.json exports

MEDIUM Call track() before init() with subscribers

Subscribers are configured in init(). Without init({ subscribers: [...] }), track() has nowhere to send events. Call init() once at app startup before any track().

Source: packages/autotel/src/event.ts

MEDIUM Omit peer dependency for the chosen adapter

Install the platform SDK for the subscriber you use (e.g. posthog-node, @segment/analytics-node). Missing peer deps can cause runtime errors or no-op behavior.

Source: packages/autotel-subscribers/package.json peerDependencies

Version

Targets autotel-subscribers v27.x. Requires autotel (workspace). See also: autotel package skill autotel-events for track() and Event API.