@refraction-ui/astro 0.6.0 → 0.8.0

package/dist/analytics-sink-posthog/sink.ts

@@ -0,0 +1,37 @@
+import type { AnalyticsSink } from '../analytics/index.ts'
+import {
+  createPostHogHttpSink,
+  type PostHogHttpSinkOptions,
+} from './http-sink.js'
+import {
+  createPostHogClientSdkSink,
+  type PostHogClientSdkSinkOptions,
+} from './client-sdk-sink.js'
+
+/** PostHog fan-out mode. `http` is the default (no browser library). */
+export type PostHogSinkMode = 'http' | 'client-sdk'
+
+export type PostHogSinkOptions =
+  | ({ mode?: 'http' } & PostHogHttpSinkOptions)
+  | ({ mode: 'client-sdk' } & PostHogClientSdkSinkOptions)
+
+/**
+ * Create a PostHog `AnalyticsSink`.
+ *
+ * - `mode: 'http'` (DEFAULT) — pure protocol adapter against PostHog's
+ *   `/capture` + `/batch` API. No `posthog-js`. Server-relay friendly.
+ * - `mode: 'client-sdk'` — OPTIONAL. Lazily dynamic-imports `posthog-js`
+ *   for client-exclusive features. Only loaded if this mode is selected.
+ *
+ * Session replay is NOT configurable here — import the separate
+ * `@refraction-ui/analytics-sink-posthog/replay` module to opt in. It is
+ * never on the event path and tree-shakes away when unused.
+ */
+export function createPostHogSink(
+  options: PostHogSinkOptions,
+): AnalyticsSink {
+  if (options.mode === 'client-sdk') {
+    return createPostHogClientSdkSink(options)
+  }
+  return createPostHogHttpSink(options)
+}

package/dist/astro-analytics/index.ts

@@ -47,3 +47,48 @@ export {
   type CreateMockSinkOptions,
   type Redactor,
 } from '../analytics/index.ts'
+
+// Re-export vendor sink factories so consumers of the public meta can fan
+// out to GA4 / Azure App Insights / PostHog. The sink packages stay private;
+// they reach consumers only through this adapter (and the meta's `export *`).
+// Named re-exports only — `export *` would collide on shared mapping helpers
+// (each sink re-exports its own `mapEvent`). Mapping helpers are intentionally
+// not surfaced here; only the sink factories + their option/type contracts.
+export {
+  createGA4Sink,
+  createGA4HttpSink,
+  createGA4ClientSdkSink,
+  type GA4SinkOptions,
+  type GA4HttpOptions,
+  type GA4ClientSdkOptions,
+  type GA4ConsentBridge,
+  type ConsentState,
+  type GtagFn,
+} from '../analytics-sink-ga4/index.ts'
+
+export {
+  createAppInsightsSink,
+  type AppInsightsSinkOptions,
+  type AppInsightsSinkMode,
+  type ClientSdkOptions,
+  type HttpOptions,
+  type AppInsightsLike,
+} from '../analytics-sink-app-insights/index.ts'
+
+export {
+  createPostHogSink,
+  createPostHogHttpSink,
+  createPostHogClientSdkSink,
+  type PostHogSinkMode,
+  type PostHogSinkOptions,
+  type PostHogHttpSinkOptions,
+  type PostHogClientSdkSinkOptions,
+} from '../analytics-sink-posthog/index.ts'
+
+// Optional, lazy PostHog session replay (separate `./replay` entry point of
+// the sink package — never on the event path, tree-shaken when unused).
+export {
+  startSessionReplay,
+  type SessionReplayOptions,
+  type SessionReplayHandle,
+} from '../analytics-sink-posthog/replay.ts'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@refraction-ui/astro",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "All Refraction UI Astro components in one package",
   "type": "module",
   "exports": {
@@ -10,8 +10,12 @@
     "dist"
   ],
   "scripts": {
-    "build": "node build.mjs"
+    "build": "node build.mjs",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage --passWithNoTests"
   },
+  "dependencies": {},
   "peerDependencies": {
     "astro": ">=4.0.0"
   },