@seriphxyz/core 0.1.2 → 0.1.8

package/README.md

@@ -0,0 +1,277 @@
+# @seriphxyz/core
+
+> **Note:** This repo is a read-only mirror. Source lives in a private monorepo.
+> For issues/PRs, please open them here and we'll sync changes back.
+
+Framework-agnostic API client, types, and headless controllers for [Seriph](https://seriph.xyz) widgets.
+
+## Installation
+
+```bash
+npm install @seriphxyz/core
+```
+
+This is the base package used by `@seriphxyz/astro`, `@seriphxyz/react`, and `@seriphxyz/solid`. Use it directly when building custom integrations or with any JavaScript framework.
+
+## API Functions
+
+### Comments
+
+```ts
+import { fetchComments, postComment } from "@seriphxyz/core";
+
+// Fetch comments for a page
+const comments = await fetchComments({
+  siteKey: "your-key",
+  pageId: "my-page",
+});
+
+// Post a new comment
+await postComment({
+  siteKey: "your-key",
+  pageId: "my-page",
+  authorName: "John",
+  content: "Great post!",
+  authorEmail: "john@example.com", // optional
+  parentId: "comment-id", // optional, for replies
+});
+```
+
+### Reactions
+
+```ts
+import { fetchReactions, addReaction, removeReaction } from "@seriphxyz/core";
+
+// Fetch reactions for a page
+const { counts, userReactions } = await fetchReactions({
+  siteKey: "your-key",
+  pageId: "my-page",
+});
+
+// Add a reaction
+await addReaction({
+  siteKey: "your-key",
+  pageId: "my-page",
+  reactionType: "like", // or 'clap', 'heart', etc.
+});
+
+// Remove a reaction
+await removeReaction({
+  siteKey: "your-key",
+  pageId: "my-page",
+  reactionType: "like",
+});
+```
+
+### Forms
+
+```ts
+import { submitForm } from "@seriphxyz/core";
+
+await submitForm({
+  siteKey: "your-key",
+  formSlug: "contact",
+  data: {
+    name: "John",
+    email: "john@example.com",
+    message: "Hello!",
+  },
+});
+```
+
+### Subscriptions
+
+```ts
+import { subscribe } from "@seriphxyz/core";
+
+await subscribe({
+  siteKey: "your-key",
+  email: "user@example.com",
+});
+```
+
+### Waitlist
+
+```ts
+import { joinWaitlist } from "@seriphxyz/core";
+
+await joinWaitlist({
+  siteKey: "your-key",
+  email: "user@example.com",
+  name: "John", // optional
+  source: "homepage", // optional
+});
+```
+
+### Feedback
+
+```ts
+import { submitFeedback } from "@seriphxyz/core";
+
+await submitFeedback({
+  siteKey: "your-key",
+  type: "bug", // 'bug' | 'feature' | 'general'
+  content: "Found an issue...",
+  email: "user@example.com", // optional
+  pageUrl: "/about", // optional
+});
+```
+
+### Polls
+
+```ts
+import { fetchPoll, votePoll } from "@seriphxyz/core";
+
+// Fetch poll data
+const poll = await fetchPoll({
+  siteKey: "your-key",
+  pollId: 123,
+});
+
+// Vote on a poll
+await votePoll({
+  siteKey: "your-key",
+  pollId: 123,
+  selectedOptions: ["option-1", "option-2"],
+});
+```
+
+### Views
+
+```ts
+import { getViewCounts, recordView } from "@seriphxyz/core";
+
+// Get view counts
+const { views, uniqueVisitors } = await getViewCounts({
+  siteKey: "your-key",
+  pageId: "my-page",
+});
+
+// Record a view
+await recordView({
+  siteKey: "your-key",
+  pageId: "my-page",
+});
+```
+
+### Announcements
+
+```ts
+import { fetchAnnouncements, dismissAnnouncement } from "@seriphxyz/core";
+
+// Fetch active announcements
+const announcements = await fetchAnnouncements({
+  siteKey: "your-key",
+});
+
+// Dismiss an announcement
+await dismissAnnouncement({
+  siteKey: "your-key",
+  announcementId: 123,
+});
+```
+
+### Posts
+
+```ts
+import { fetchPosts, fetchPost } from "@seriphxyz/core";
+
+// Fetch all published posts
+const posts = await fetchPosts({
+  siteKey: "your-key",
+  tag: "tutorials", // optional filter
+  limit: 10, // optional
+});
+
+// Fetch a single post
+const post = await fetchPost({
+  siteKey: "your-key",
+  slug: "my-post",
+});
+```
+
+## Headless Controllers
+
+Controllers manage state without any DOM dependencies. Use them to build custom UI or integrate with any framework.
+
+```ts
+import {
+  SubscribeController,
+  FormController,
+  ReactionsController,
+  CommentsController,
+  WaitlistController,
+  FeedbackController,
+  PollController,
+  AnnouncementsController,
+  ViewCountsController,
+} from "@seriphxyz/core";
+
+// Example: Subscribe controller
+const controller = new SubscribeController({ siteKey: "your-key" });
+
+// Subscribe to state changes
+controller.subscribe((state) => {
+  console.log(state.status); // 'idle' | 'loading' | 'success' | 'error'
+  console.log(state.message);
+  console.log(state.error);
+});
+
+// Submit
+await controller.submit("user@example.com");
+
+// Reset
+controller.reset();
+```
+
+### Available Controllers
+
+| Controller | Purpose |
+|------------|---------|
+| `SubscribeController` | Email subscriptions |
+| `FormController` | Form submissions |
+| `ReactionsController` | Page reactions |
+| `CommentsController` | Threaded comments |
+| `WaitlistController` | Waitlist signups |
+| `FeedbackController` | Feedback forms |
+| `PollController` | Polls and voting |
+| `AnnouncementsController` | Site announcements |
+| `ViewCountsController` | Page view tracking |
+
+## Visitor Management
+
+Reactions and views track visitors using localStorage. For authenticated users, you can set a custom visitor ID:
+
+```ts
+import { setVisitorId, getVisitorId } from "@seriphxyz/core";
+
+// Set custom visitor ID (e.g., for logged-in users)
+setVisitorId("user-123");
+
+// Get current visitor ID
+const visitorId = getVisitorId();
+
+// Revert to localStorage-based ID
+setVisitorId(null);
+```
+
+## Types
+
+All types are exported for TypeScript users:
+
+```ts
+import type {
+  SeriphConfig,
+  Comment,
+  ReactionCounts,
+  SeriphPost,
+  Poll,
+  Announcement,
+  FeedbackType,
+  ControllerStatus,
+} from "@seriphxyz/core";
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -6,6 +6,7 @@
  */
 export declare const DEFAULT_ENDPOINT = "https://seriph.xyz";
 export declare const API_PATH = "/api/v1";
+export declare const VISITOR_STORAGE_KEY = "seriph_visitor_id";
 export interface SeriphConfig {
     /** Your site key (required) */
     siteKey: string;
@@ -52,6 +53,17 @@ export interface SeriphPost {
 export declare function buildUrl(endpoint: string | undefined, path: string): string;
 /** Get site key from config */
 export declare function getSiteKey(config: SeriphConfig): string;
+/**
+ * Set a custom visitor ID (e.g., authenticated user ID).
+ * Useful for non-static sites where you have user sessions.
+ * Set to null to revert to localStorage-based ID.
+ */
+export declare function setVisitorId(id: string | null): void;
+/**
+ * Get the current visitor ID.
+ * Priority: custom ID > localStorage > generated UUID (SSR fallback)
+ */
+export declare function getVisitorId(): string;
 export interface SubmitFormOptions extends SeriphConfig {
     formSlug: string;
     data: Record<string, unknown>;
@@ -74,7 +86,11 @@ export declare function postComment(options: PostCommentOptions): Promise<Commen
 export interface FetchReactionsOptions extends SeriphConfig {
     pageId: string;
 }
-export declare function fetchReactions(options: FetchReactionsOptions): Promise<ReactionCounts>;
+export interface FetchReactionsResponse extends ReactionCounts {
+    /** Reaction types the current visitor has added (based on visitor token) */
+    userReactions: string[];
+}
+export declare function fetchReactions(options: FetchReactionsOptions): Promise<FetchReactionsResponse>;
 export interface AddReactionOptions extends SeriphConfig {
     pageId: string;
     reactionType?: string;
@@ -107,6 +123,98 @@ export interface FetchPostOptions extends SeriphConfig {
     slug: string;
 }
 export declare function fetchPost(options: FetchPostOptions): Promise<SeriphPost | null>;
+export interface JoinWaitlistOptions extends SeriphConfig {
+    email: string;
+    name?: string;
+    /** Where the signup came from (e.g., "homepage", "blog") */
+    source?: string;
+}
+export interface JoinWaitlistResponse {
+    success: boolean;
+    message: string;
+    /** Position in waitlist (if site chooses to show it) */
+    position?: number;
+}
+export declare function joinWaitlist(options: JoinWaitlistOptions): Promise<JoinWaitlistResponse>;
+export interface ViewCountsOptions extends SeriphConfig {
+    pageId: string;
+}
+export interface ViewCounts {
+    pageId: string;
+    views: number;
+    uniqueVisitors: number;
+}
+export interface RecordViewResponse extends ViewCounts {
+    isNewVisitor: boolean;
+}
+export declare function getViewCounts(options: ViewCountsOptions): Promise<ViewCounts>;
+export declare function recordView(options: ViewCountsOptions): Promise<RecordViewResponse>;
+export type FeedbackType = "bug" | "feature" | "general";
+export interface SubmitFeedbackOptions extends SeriphConfig {
+    type: FeedbackType;
+    content: string;
+    email?: string;
+    /** Page URL where feedback was submitted */
+    pageUrl?: string;
+}
+export interface SubmitFeedbackResponse {
+    success: boolean;
+    message: string;
+}
+export declare function submitFeedback(options: SubmitFeedbackOptions): Promise<SubmitFeedbackResponse>;
+export type ShowResultsMode = "always" | "after_vote" | "after_end" | "never";
+export interface PollOption {
+    id: string;
+    text: string;
+}
+export interface PollSettings {
+    multiSelect: boolean;
+    showResults: ShowResultsMode;
+}
+export interface Poll {
+    id: number;
+    question: string;
+    options: PollOption[];
+    settings: PollSettings;
+    endsAt?: string;
+    isActive: boolean;
+}
+export interface PollWithResults extends Poll {
+    results: Record<string, number>;
+    totalVotes: number;
+    /** Options the current visitor has voted for */
+    userVotes?: string[];
+}
+export interface FetchPollOptions extends SeriphConfig {
+    pollId: number;
+}
+export declare function fetchPoll(options: FetchPollOptions): Promise<PollWithResults>;
+export interface VotePollOptions extends SeriphConfig {
+    pollId: number;
+    selectedOptions: string[];
+}
+export interface VotePollResponse {
+    success: boolean;
+    results: Record<string, number>;
+    totalVotes: number;
+}
+export declare function votePoll(options: VotePollOptions): Promise<VotePollResponse>;
+export type AnnouncementType = "info" | "warning" | "success" | "error";
+export interface Announcement {
+    id: number;
+    content: string;
+    announcementType: AnnouncementType;
+    linkUrl?: string;
+    linkText?: string;
+    isDismissible: boolean;
+}
+export interface FetchAnnouncementsOptions extends SeriphConfig {
+}
+export declare function fetchAnnouncements(options: FetchAnnouncementsOptions): Promise<Announcement[]>;
+export interface DismissAnnouncementOptions extends SeriphConfig {
+    announcementId: number;
+}
+export declare function dismissAnnouncement(options: DismissAnnouncementOptions): Promise<void>;
 export type ControllerStatus = "idle" | "loading" | "success" | "error";
 /** State for subscribe controllers */
 export interface SubscribeState {
@@ -133,6 +241,13 @@ export interface CommentsState {
     status: ControllerStatus;
     error: Error | null;
 }
+/** State for waitlist controllers */
+export interface WaitlistState {
+    status: ControllerStatus;
+    message: string | null;
+    position: number | null;
+    error: Error | null;
+}
 export interface ControllerListener<T> {
     (state: T): void;
 }
@@ -162,6 +277,32 @@ export declare class SubscribeController {
     /** Reset to idle state */
     reset(): void;
 }
+/**
+ * Headless controller for waitlist forms.
+ * Manages state without any DOM/framework dependencies.
+ *
+ * @example
+ * const controller = new WaitlistController({ siteKey: 'xxx' });
+ * controller.subscribe((state) => {
+ *   console.log(state.status, state.message, state.position);
+ * });
+ * await controller.join('user@example.com', { name: 'John', source: 'homepage' });
+ */
+export declare class WaitlistController {
+    private config;
+    private listeners;
+    private _state;
+    constructor(config: SeriphConfig);
+    getState(): WaitlistState;
+    subscribe(listener: ControllerListener<WaitlistState>): () => void;
+    private notify;
+    /** Join the waitlist */
+    join(email: string, options?: {
+        name?: string;
+        source?: string;
+    }): Promise<JoinWaitlistResponse>;
+    reset(): void;
+}
 /**
  * Headless controller for forms.
  * Manages state without any DOM/framework dependencies.
@@ -217,4 +358,106 @@ export declare class CommentsController {
         parentId?: string;
     }): Promise<Comment>;
 }
+/** State for feedback controllers */
+export interface FeedbackState {
+    status: ControllerStatus;
+    message: string | null;
+    error: Error | null;
+}
+/**
+ * Headless controller for feedback forms.
+ * Manages state without any DOM/framework dependencies.
+ */
+export declare class FeedbackController {
+    private config;
+    private listeners;
+    private _state;
+    constructor(config: SeriphConfig);
+    getState(): FeedbackState;
+    subscribe(listener: ControllerListener<FeedbackState>): () => void;
+    private notify;
+    submit(type: FeedbackType, content: string, options?: {
+        email?: string;
+        pageUrl?: string;
+    }): Promise<SubmitFeedbackResponse>;
+    reset(): void;
+}
+/** State for poll controllers */
+export interface PollState {
+    poll: PollWithResults | null;
+    status: ControllerStatus;
+    error: Error | null;
+}
+/**
+ * Headless controller for polls.
+ * Manages poll state, voting, and results.
+ */
+export declare class PollController {
+    private config;
+    private pollId;
+    private listeners;
+    private _state;
+    constructor(config: SeriphConfig, pollId: number);
+    getState(): PollState;
+    subscribe(listener: ControllerListener<PollState>): () => void;
+    private notify;
+    /** Fetch poll data from the server */
+    fetch(): Promise<PollWithResults>;
+    /** Vote on the poll */
+    vote(selectedOptions: string[]): Promise<VotePollResponse>;
+    /** Check if user has voted */
+    hasVoted(): boolean;
+}
+/** State for announcements controllers */
+export interface AnnouncementsState {
+    announcements: Announcement[];
+    dismissed: Set<number>;
+    status: ControllerStatus;
+    error: Error | null;
+}
+/**
+ * Headless controller for announcements.
+ * Manages announcement list and dismissals.
+ */
+export declare class AnnouncementsController {
+    private config;
+    private listeners;
+    private _state;
+    constructor(config: SeriphConfig);
+    getState(): AnnouncementsState;
+    /** Get visible (non-dismissed) announcements */
+    getVisibleAnnouncements(): Announcement[];
+    subscribe(listener: ControllerListener<AnnouncementsState>): () => void;
+    private notify;
+    /** Fetch announcements from the server */
+    fetch(): Promise<Announcement[]>;
+    /** Dismiss an announcement */
+    dismiss(announcementId: number): Promise<void>;
+}
+/** State for view counts controllers */
+export interface ViewCountsState {
+    pageId: string;
+    views: number;
+    uniqueVisitors: number;
+    status: ControllerStatus;
+    error: Error | null;
+}
+/**
+ * Headless controller for view counts.
+ * Tracks page views and unique visitors.
+ */
+export declare class ViewCountsController {
+    private config;
+    private pageId;
+    private listeners;
+    private _state;
+    constructor(config: SeriphConfig, pageId: string);
+    getState(): ViewCountsState;
+    subscribe(listener: ControllerListener<ViewCountsState>): () => void;
+    private notify;
+    /** Fetch view counts from the server */
+    fetch(): Promise<ViewCounts>;
+    /** Record a view (automatically tracks unique visitors via visitor token) */
+    record(): Promise<RecordViewResponse>;
+}
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -9,6 +9,7 @@
 // =============================================================================
 export const DEFAULT_ENDPOINT = "https://seriph.xyz";
 export const API_PATH = "/api/v1";
+export const VISITOR_STORAGE_KEY = "seriph_visitor_id";
 // =============================================================================
 // Helpers
 // =============================================================================
@@ -24,6 +25,69 @@ export function getSiteKey(config) {
     }
     return config.siteKey;
 }
+// =============================================================================
+// Visitor Token Management
+// =============================================================================
+/** Custom visitor ID set by the site (e.g., authenticated user ID) */
+let customVisitorId = null;
+/** Generate a random UUID v4 */
+function generateUUID() {
+    // Use crypto.randomUUID if available, otherwise fallback
+    if (typeof crypto !== "undefined" && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    // Fallback for older environments
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === "x" ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+/**
+ * Set a custom visitor ID (e.g., authenticated user ID).
+ * Useful for non-static sites where you have user sessions.
+ * Set to null to revert to localStorage-based ID.
+ */
+export function setVisitorId(id) {
+    customVisitorId = id;
+}
+/**
+ * Get the current visitor ID.
+ * Priority: custom ID > localStorage > generated UUID (SSR fallback)
+ */
+export function getVisitorId() {
+    // Use custom ID if set (for authenticated users)
+    if (customVisitorId) {
+        return customVisitorId;
+    }
+    // SSR check - localStorage only exists in browser
+    if (typeof window === "undefined" || typeof localStorage === "undefined") {
+        // Return a temporary UUID for SSR - will be replaced client-side
+        return generateUUID();
+    }
+    // Use localStorage for anonymous visitors
+    let visitorId = localStorage.getItem(VISITOR_STORAGE_KEY);
+    if (!visitorId) {
+        visitorId = generateUUID();
+        localStorage.setItem(VISITOR_STORAGE_KEY, visitorId);
+    }
+    return visitorId;
+}
+/** Get common headers for API requests */
+function getHeaders(siteKey) {
+    let visitorId;
+    try {
+        visitorId = getVisitorId();
+    }
+    catch {
+        // Fallback if localStorage access fails (e.g., private browsing, SSR)
+        visitorId = generateUUID();
+    }
+    return {
+        "X-Seriph-Key": siteKey,
+        "X-Seriph-Visitor": visitorId,
+    };
+}
 export async function submitForm(options) {
     const { endpoint, formSlug, data, formLoadTime } = options;
     const siteKey = getSiteKey(options);
@@ -35,8 +99,8 @@ export async function submitForm(options) {
     const response = await fetch(url, {
         method: "POST",
         headers: {
+            ...getHeaders(siteKey),
             "Content-Type": "application/json",
-            "X-Seriph-Key": siteKey,
         },
         body: JSON.stringify(payload),
     });
@@ -50,9 +114,7 @@ export async function fetchComments(options) {
     const siteKey = getSiteKey(options);
     const url = buildUrl(endpoint, `/comments/${encodeURIComponent(pageId)}`);
     const response = await fetch(url, {
-        headers: {
-            "X-Seriph-Key": siteKey,
-        },
+        headers: getHeaders(siteKey),
     });
     if (!response.ok) {
         throw new Error(`Failed to fetch comments: ${response.statusText}`);
@@ -67,8 +129,8 @@ export async function postComment(options) {
     const response = await fetch(url, {
         method: "POST",
         headers: {
+            ...getHeaders(siteKey),
             "Content-Type": "application/json",
-            "X-Seriph-Key": siteKey,
         },
         body: JSON.stringify({
             authorName,
@@ -88,15 +150,16 @@ export async function fetchReactions(options) {
     const siteKey = getSiteKey(options);
     const url = buildUrl(endpoint, `/reactions/${encodeURIComponent(pageId)}`);
     const response = await fetch(url, {
-        headers: {
-            "X-Seriph-Key": siteKey,
-        },
+        headers: getHeaders(siteKey),
     });
     if (!response.ok) {
         throw new Error(`Failed to fetch reactions: ${response.statusText}`);
     }
     const data = await response.json();
-    return data.data;
+    return {
+        ...data.data,
+        userReactions: data.data.userReactions || [],
+    };
 }
 export async function addReaction(options) {
     const { endpoint, pageId, reactionType = "like" } = options;
@@ -105,8 +168,8 @@ export async function addReaction(options) {
     const response = await fetch(url, {
         method: "POST",
         headers: {
+            ...getHeaders(siteKey),
             "Content-Type": "application/json",
-            "X-Seriph-Key": siteKey,
         },
         body: JSON.stringify({ reactionType }),
     });
@@ -123,8 +186,8 @@ export async function removeReaction(options) {
     const response = await fetch(url, {
         method: "DELETE",
         headers: {
+            ...getHeaders(siteKey),
             "Content-Type": "application/json",
-            "X-Seriph-Key": siteKey,
         },
         body: JSON.stringify({ reactionType }),
     });
@@ -141,8 +204,8 @@ export async function subscribe(options) {
     const response = await fetch(url, {
         method: "POST",
         headers: {
+            ...getHeaders(siteKey),
             "Content-Type": "application/json",
-            "X-Seriph-Key": siteKey,
         },
         body: JSON.stringify({ email }),
     });
@@ -161,9 +224,7 @@ export async function fetchPosts(options) {
         url.searchParams.set("tag", tag);
     }
     const response = await fetch(url.toString(), {
-        headers: {
-            "X-Seriph-Key": siteKey,
-        },
+        headers: getHeaders(siteKey),
     });
     if (!response.ok) {
         throw new Error(`Failed to fetch posts: ${response.status} ${response.statusText}`);
@@ -176,9 +237,7 @@ export async function fetchPost(options) {
     const siteKey = getSiteKey(options);
     const baseUrl = (endpoint || DEFAULT_ENDPOINT).replace(/\/+$/, "") + API_PATH;
     const response = await fetch(`${baseUrl}/posts/${encodeURIComponent(slug)}`, {
-        headers: {
-            "X-Seriph-Key": siteKey,
-        },
+        headers: getHeaders(siteKey),
     });
     if (response.status === 404) {
         return null;
@@ -189,6 +248,128 @@ export async function fetchPost(options) {
     const data = await response.json();
     return data.public_post || data;
 }
+export async function joinWaitlist(options) {
+    const { endpoint, email, name, source } = options;
+    const siteKey = getSiteKey(options);
+    const url = buildUrl(endpoint, "/waitlist");
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            ...getHeaders(siteKey),
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ email, name, source }),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to join waitlist: ${response.statusText}`);
+    }
+    return response.json();
+}
+export async function getViewCounts(options) {
+    const { endpoint, pageId } = options;
+    const siteKey = getSiteKey(options);
+    const url = buildUrl(endpoint, `/views/${encodeURIComponent(pageId)}`);
+    const response = await fetch(url, {
+        headers: getHeaders(siteKey),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to get view counts: ${response.statusText}`);
+    }
+    const data = await response.json();
+    return data.data;
+}
+export async function recordView(options) {
+    const { endpoint, pageId } = options;
+    const siteKey = getSiteKey(options);
+    const url = buildUrl(endpoint, `/views/${encodeURIComponent(pageId)}`);
+    const response = await fetch(url, {
+        method: "POST",
+        headers: getHeaders(siteKey),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to record view: ${response.statusText}`);
+    }
+    const data = await response.json();
+    return data.data;
+}
+export async function submitFeedback(options) {
+    const { endpoint, type, content, email, pageUrl } = options;
+    const siteKey = getSiteKey(options);
+    const url = buildUrl(endpoint, "/feedback");
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            ...getHeaders(siteKey),
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            feedback_type: type,
+            content,
+            email,
+            page_url: pageUrl,
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to submit feedback: ${response.statusText}`);
+    }
+    return response.json();
+}
+export async function fetchPoll(options) {
+    const { endpoint, pollId } = options;
+    const siteKey = getSiteKey(options);
+    const url = buildUrl(endpoint, `/polls/${pollId}`);
+    const response = await fetch(url, {
+        headers: getHeaders(siteKey),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch poll: ${response.statusText}`);
+    }
+    const data = await response.json();
+    return data.data;
+}
+export async function votePoll(options) {
+    const { endpoint, pollId, selectedOptions } = options;
+    const siteKey = getSiteKey(options);
+    const url = buildUrl(endpoint, `/polls/${pollId}/vote`);
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            ...getHeaders(siteKey),
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ selected_options: selectedOptions }),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to vote: ${response.statusText}`);
+    }
+    const data = await response.json();
+    return data.data;
+}
+export async function fetchAnnouncements(options) {
+    const { endpoint } = options;
+    const siteKey = getSiteKey(options);
+    const url = buildUrl(endpoint, "/announcements");
+    const response = await fetch(url, {
+        headers: getHeaders(siteKey),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch announcements: ${response.statusText}`);
+    }
+    const data = await response.json();
+    return data.data || [];
+}
+export async function dismissAnnouncement(options) {
+    const { endpoint, announcementId } = options;
+    const siteKey = getSiteKey(options);
+    const url = buildUrl(endpoint, `/announcements/${announcementId}/dismiss`);
+    const response = await fetch(url, {
+        method: "POST",
+        headers: getHeaders(siteKey),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to dismiss announcement: ${response.statusText}`);
+    }
+}
 /**
  * Headless controller for subscribe forms.
  * Manages state without any DOM/framework dependencies.
@@ -247,6 +428,70 @@ export class SubscribeController {
         this.notify();
     }
 }
+/**
+ * Headless controller for waitlist forms.
+ * Manages state without any DOM/framework dependencies.
+ *
+ * @example
+ * const controller = new WaitlistController({ siteKey: 'xxx' });
+ * controller.subscribe((state) => {
+ *   console.log(state.status, state.message, state.position);
+ * });
+ * await controller.join('user@example.com', { name: 'John', source: 'homepage' });
+ */
+export class WaitlistController {
+    config;
+    listeners = new Set();
+    _state = { status: "idle", message: null, position: null, error: null };
+    constructor(config) {
+        this.config = config;
+    }
+    getState() {
+        return { ...this._state };
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        listener(this.getState());
+        return () => this.listeners.delete(listener);
+    }
+    notify() {
+        const state = this.getState();
+        for (const listener of this.listeners) {
+            listener(state);
+        }
+    }
+    /** Join the waitlist */
+    async join(email, options) {
+        this._state = { status: "loading", message: null, position: null, error: null };
+        this.notify();
+        try {
+            const result = await joinWaitlist({
+                ...this.config,
+                email,
+                name: options?.name,
+                source: options?.source,
+            });
+            this._state = {
+                status: "success",
+                message: result.message,
+                position: result.position ?? null,
+                error: null,
+            };
+            this.notify();
+            return result;
+        }
+        catch (e) {
+            const error = e instanceof Error ? e : new Error(String(e));
+            this._state = { status: "error", message: error.message, position: null, error };
+            this.notify();
+            throw error;
+        }
+    }
+    reset() {
+        this._state = { status: "idle", message: null, position: null, error: null };
+        this.notify();
+    }
+}
 /**
  * Headless controller for forms.
  * Manages state without any DOM/framework dependencies.
@@ -336,7 +581,13 @@ export class ReactionsController {
         this.notify();
         try {
             const result = await fetchReactions({ ...this.config, pageId: this.pageId });
-            this._state = { ...this._state, counts: result.counts, status: "success", error: null };
+            this._state = {
+                ...this._state,
+                counts: result.counts,
+                userReactions: result.userReactions,
+                status: "success",
+                error: null,
+            };
             this.notify();
             return this.getState();
         }
@@ -444,3 +695,272 @@ export class CommentsController {
         }
     }
 }
+/**
+ * Headless controller for feedback forms.
+ * Manages state without any DOM/framework dependencies.
+ */
+export class FeedbackController {
+    config;
+    listeners = new Set();
+    _state = { status: "idle", message: null, error: null };
+    constructor(config) {
+        this.config = config;
+    }
+    getState() {
+        return { ...this._state };
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        listener(this.getState());
+        return () => this.listeners.delete(listener);
+    }
+    notify() {
+        const state = this.getState();
+        for (const listener of this.listeners) {
+            listener(state);
+        }
+    }
+    async submit(type, content, options) {
+        this._state = { status: "loading", message: null, error: null };
+        this.notify();
+        try {
+            const result = await submitFeedback({
+                ...this.config,
+                type,
+                content,
+                email: options?.email,
+                pageUrl: options?.pageUrl,
+            });
+            this._state = { status: "success", message: result.message, error: null };
+            this.notify();
+            return result;
+        }
+        catch (e) {
+            const error = e instanceof Error ? e : new Error(String(e));
+            this._state = { status: "error", message: error.message, error };
+            this.notify();
+            throw error;
+        }
+    }
+    reset() {
+        this._state = { status: "idle", message: null, error: null };
+        this.notify();
+    }
+}
+/**
+ * Headless controller for polls.
+ * Manages poll state, voting, and results.
+ */
+export class PollController {
+    config;
+    pollId;
+    listeners = new Set();
+    _state = { poll: null, status: "idle", error: null };
+    constructor(config, pollId) {
+        this.config = config;
+        this.pollId = pollId;
+    }
+    getState() {
+        return { ...this._state };
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        listener(this.getState());
+        return () => this.listeners.delete(listener);
+    }
+    notify() {
+        const state = this.getState();
+        for (const listener of this.listeners) {
+            listener(state);
+        }
+    }
+    /** Fetch poll data from the server */
+    async fetch() {
+        this._state = { ...this._state, status: "loading", error: null };
+        this.notify();
+        try {
+            const poll = await fetchPoll({ ...this.config, pollId: this.pollId });
+            this._state = { poll, status: "success", error: null };
+            this.notify();
+            return poll;
+        }
+        catch (e) {
+            const error = e instanceof Error ? e : new Error(String(e));
+            this._state = { ...this._state, status: "error", error };
+            this.notify();
+            throw error;
+        }
+    }
+    /** Vote on the poll */
+    async vote(selectedOptions) {
+        try {
+            const result = await votePoll({
+                ...this.config,
+                pollId: this.pollId,
+                selectedOptions,
+            });
+            // Update state with new results
+            if (this._state.poll) {
+                this._state.poll = {
+                    ...this._state.poll,
+                    results: result.results,
+                    totalVotes: result.totalVotes,
+                    userVotes: selectedOptions,
+                };
+            }
+            this.notify();
+            return result;
+        }
+        catch (e) {
+            const error = e instanceof Error ? e : new Error(String(e));
+            this._state = { ...this._state, error };
+            this.notify();
+            throw error;
+        }
+    }
+    /** Check if user has voted */
+    hasVoted() {
+        return !!this._state.poll?.userVotes && this._state.poll.userVotes.length > 0;
+    }
+}
+/**
+ * Headless controller for announcements.
+ * Manages announcement list and dismissals.
+ */
+export class AnnouncementsController {
+    config;
+    listeners = new Set();
+    _state = {
+        announcements: [],
+        dismissed: new Set(),
+        status: "idle",
+        error: null,
+    };
+    constructor(config) {
+        this.config = config;
+    }
+    getState() {
+        return {
+            ...this._state,
+            announcements: [...this._state.announcements],
+            dismissed: new Set(this._state.dismissed),
+        };
+    }
+    /** Get visible (non-dismissed) announcements */
+    getVisibleAnnouncements() {
+        return this._state.announcements.filter((a) => !this._state.dismissed.has(a.id));
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        listener(this.getState());
+        return () => this.listeners.delete(listener);
+    }
+    notify() {
+        const state = this.getState();
+        for (const listener of this.listeners) {
+            listener(state);
+        }
+    }
+    /** Fetch announcements from the server */
+    async fetch() {
+        this._state = { ...this._state, status: "loading", error: null };
+        this.notify();
+        try {
+            const announcements = await fetchAnnouncements(this.config);
+            this._state = { ...this._state, announcements, status: "success", error: null };
+            this.notify();
+            return announcements;
+        }
+        catch (e) {
+            const error = e instanceof Error ? e : new Error(String(e));
+            this._state = { ...this._state, status: "error", error };
+            this.notify();
+            throw error;
+        }
+    }
+    /** Dismiss an announcement */
+    async dismiss(announcementId) {
+        try {
+            await dismissAnnouncement({ ...this.config, announcementId });
+            this._state.dismissed.add(announcementId);
+            this.notify();
+        }
+        catch (e) {
+            const error = e instanceof Error ? e : new Error(String(e));
+            this._state = { ...this._state, error };
+            this.notify();
+            throw error;
+        }
+    }
+}
+/**
+ * Headless controller for view counts.
+ * Tracks page views and unique visitors.
+ */
+export class ViewCountsController {
+    config;
+    pageId;
+    listeners = new Set();
+    _state;
+    constructor(config, pageId) {
+        this.config = config;
+        this.pageId = pageId;
+        this._state = { pageId, views: 0, uniqueVisitors: 0, status: "idle", error: null };
+    }
+    getState() {
+        return { ...this._state };
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        listener(this.getState());
+        return () => this.listeners.delete(listener);
+    }
+    notify() {
+        const state = this.getState();
+        for (const listener of this.listeners) {
+            listener(state);
+        }
+    }
+    /** Fetch view counts from the server */
+    async fetch() {
+        this._state = { ...this._state, status: "loading", error: null };
+        this.notify();
+        try {
+            const counts = await getViewCounts({ ...this.config, pageId: this.pageId });
+            this._state = {
+                ...this._state,
+                views: counts.views,
+                uniqueVisitors: counts.uniqueVisitors,
+                status: "success",
+                error: null,
+            };
+            this.notify();
+            return counts;
+        }
+        catch (e) {
+            const error = e instanceof Error ? e : new Error(String(e));
+            this._state = { ...this._state, status: "error", error };
+            this.notify();
+            throw error;
+        }
+    }
+    /** Record a view (automatically tracks unique visitors via visitor token) */
+    async record() {
+        try {
+            const result = await recordView({ ...this.config, pageId: this.pageId });
+            this._state = {
+                ...this._state,
+                views: result.views,
+                uniqueVisitors: result.uniqueVisitors,
+            };
+            this.notify();
+            return result;
+        }
+        catch (e) {
+            const error = e instanceof Error ? e : new Error(String(e));
+            this._state = { ...this._state, error };
+            this.notify();
+            throw error;
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seriphxyz/core",
-  "version": "0.1.2",
+  "version": "0.1.8",
   "description": "Framework-agnostic API client and types for Seriph widgets",
   "repository": {
     "type": "git",