@seriphxyz/solid 0.1.7 → 0.1.10

package/dist/index.d.ts

@@ -30,10 +30,14 @@
  * ```
  */
 import { type Accessor } from "solid-js";
-import { type SeriphConfig, type Comment, type ControllerStatus } from "@seriphxyz/core";
-export type { SeriphConfig, SubscribeState, FormState, ReactionsState, CommentsState, Comment, ReactionCounts, SeriphPost, FetchPostsOptions, FetchPostOptions, ControllerStatus, } from "@seriphxyz/core";
-export { fetchPosts, fetchPost, DEFAULT_ENDPOINT, API_PATH, } from "@seriphxyz/core";
-export interface CreateSubscribeOptions extends SeriphConfig {
+import { type SeriphConfig, type Comment, type Announcement, type PollWithResults, type FeedbackType, type ControllerStatus } from "@seriphxyz/core";
+export type { SeriphConfig, SubscribeState, FormState, ReactionsState, CommentsState, WaitlistState, ViewCountsState, FeedbackState, PollState, AnnouncementsState, Comment, Announcement, PollWithResults, FeedbackType, ReactionCounts, SeriphPost, FetchPostsOptions, FetchPostOptions, ControllerStatus, } from "@seriphxyz/core";
+export { fetchPosts, fetchPost, getConfigFromMeta, resolveConfig, DEFAULT_ENDPOINT, API_PATH, } from "@seriphxyz/core";
+type OptionalSiteKey<T extends SeriphConfig> = Omit<T, "siteKey"> & {
+    /** Site key - optional if <meta name="seriph-site-key"> is set */
+    siteKey?: string;
+};
+export interface CreateSubscribeOptions extends OptionalSiteKey<SeriphConfig> {
 }
 export interface CreateSubscribeReturn {
     status: Accessor<ControllerStatus>;
@@ -47,15 +51,16 @@ export interface CreateSubscribeReturn {
  *
  * @example
  * ```tsx
- * const { subscribe, status, message, error } = createSubscribe({
- *   siteKey: 'your-site-key',
- * });
+ * // With explicit siteKey:
+ * const { subscribe, status } = createSubscribe({ siteKey: 'your-key' });
  *
- * <button onClick={() => subscribe('user@example.com')}>Subscribe</button>
+ * // Or with meta tag (add to document head):
+ * // <meta name="seriph-site-key" content="your-key" />
+ * const { subscribe, status } = createSubscribe({});
  * ```
  */
 export declare function createSubscribe(options: CreateSubscribeOptions): CreateSubscribeReturn;
-export interface CreateFormOptions extends SeriphConfig {
+export interface CreateFormOptions extends OptionalSiteKey<SeriphConfig> {
     /** Form slug/identifier */
     formSlug: string;
 }
@@ -72,7 +77,7 @@ export interface CreateFormReturn {
  * @example
  * ```tsx
  * const { submit, status, error } = createForm({
- *   siteKey: 'your-site-key',
+ *   siteKey: 'your-site-key', // optional with meta tag
  *   formSlug: 'contact',
  * });
  *
@@ -84,7 +89,7 @@ export interface CreateFormReturn {
  * ```
  */
 export declare function createForm(options: CreateFormOptions): CreateFormReturn;
-export interface CreateReactionsOptions extends SeriphConfig {
+export interface CreateReactionsOptions extends OptionalSiteKey<SeriphConfig> {
     /** Content identifier (e.g., post slug) */
     contentId: string;
     /** Auto-fetch reactions on mount (default: true) */
@@ -105,7 +110,6 @@ export interface CreateReactionsReturn {
  * @example
  * ```tsx
  * const { counts, userReactions, addReaction, removeReaction } = createReactions({
- *   siteKey: 'your-site-key',
  *   contentId: 'my-post-slug',
  * });
  *
@@ -115,7 +119,7 @@ export interface CreateReactionsReturn {
  * ```
  */
 export declare function createReactions(options: CreateReactionsOptions): CreateReactionsReturn;
-export interface CreateCommentsOptions extends SeriphConfig {
+export interface CreateCommentsOptions extends OptionalSiteKey<SeriphConfig> {
     /** Content identifier (e.g., post slug) */
     contentId: string;
     /** Auto-fetch comments on mount (default: true) */
@@ -137,7 +141,6 @@ export interface CreateCommentsReturn {
  * @example
  * ```tsx
  * const { comments, status, postComment } = createComments({
- *   siteKey: 'your-site-key',
  *   contentId: 'my-post-slug',
  * });
  *
@@ -155,4 +158,152 @@ export interface CreateCommentsReturn {
  * ```
  */
 export declare function createComments(options: CreateCommentsOptions): CreateCommentsReturn;
+export interface CreateWaitlistOptions extends OptionalSiteKey<SeriphConfig> {
+}
+export interface CreateWaitlistReturn {
+    status: Accessor<ControllerStatus>;
+    message: Accessor<string | null>;
+    position: Accessor<number | null>;
+    error: Accessor<Error | null>;
+    join: (email: string, options?: {
+        name?: string;
+        source?: string;
+    }) => Promise<void>;
+    reset: () => void;
+}
+/**
+ * Primitive for handling waitlist signups.
+ *
+ * @example
+ * ```tsx
+ * const { join, status, position } = createWaitlist({});
+ *
+ * <button onClick={() => join('user@example.com')}>Join Waitlist</button>
+ * {status() === 'success' && <p>You're #{position()} on the list!</p>}
+ * ```
+ */
+export declare function createWaitlist(options: CreateWaitlistOptions): CreateWaitlistReturn;
+export interface CreateViewsOptions extends OptionalSiteKey<SeriphConfig> {
+    /** Page identifier (e.g., slug or URL path) */
+    pageId: string;
+    /** Auto-record view on mount (default: true) */
+    autoRecord?: boolean;
+}
+export interface CreateViewsReturn {
+    views: Accessor<number>;
+    uniqueVisitors: Accessor<number>;
+    status: Accessor<ControllerStatus>;
+    error: Accessor<Error | null>;
+    record: () => Promise<void>;
+    refresh: () => Promise<void>;
+}
+/**
+ * Primitive for tracking and displaying page views.
+ *
+ * @example
+ * ```tsx
+ * const { views, uniqueVisitors } = createViews({
+ *   pageId: '/blog/my-post',
+ * });
+ *
+ * <span>{views()} views ({uniqueVisitors()} unique)</span>
+ * ```
+ */
+export declare function createViews(options: CreateViewsOptions): CreateViewsReturn;
+export interface CreateFeedbackOptions extends OptionalSiteKey<SeriphConfig> {
+}
+export interface CreateFeedbackReturn {
+    status: Accessor<ControllerStatus>;
+    message: Accessor<string | null>;
+    error: Accessor<Error | null>;
+    submit: (type: FeedbackType, content: string, options?: {
+        email?: string;
+        pageUrl?: string;
+    }) => Promise<void>;
+    reset: () => void;
+}
+/**
+ * Primitive for handling feedback submissions.
+ *
+ * @example
+ * ```tsx
+ * const { submit, status } = createFeedback({});
+ *
+ * <button onClick={() => submit('feature', 'Add dark mode!')}>
+ *   Submit Feedback
+ * </button>
+ * ```
+ */
+export declare function createFeedback(options: CreateFeedbackOptions): CreateFeedbackReturn;
+export interface CreatePollOptions extends OptionalSiteKey<SeriphConfig> {
+    /** Poll slug */
+    slug: string;
+    /** Auto-fetch poll on mount (default: true) */
+    autoFetch?: boolean;
+}
+export interface CreatePollReturn {
+    poll: Accessor<PollWithResults | null>;
+    status: Accessor<ControllerStatus>;
+    error: Accessor<Error | null>;
+    vote: (selectedOptions: string[]) => Promise<void>;
+    hasVoted: Accessor<boolean>;
+    refresh: () => Promise<void>;
+}
+/**
+ * Primitive for displaying and voting on polls.
+ *
+ * @example
+ * ```tsx
+ * // With meta tag: <meta name="seriph-site-key" content="your-key" />
+ * const { poll, vote, hasVoted } = createPoll({ slug: 'favorite-framework' });
+ *
+ * <Show when={poll()}>
+ *   {(p) => (
+ *     <div>
+ *       <h3>{p().question}</h3>
+ *       <For each={p().options}>
+ *         {(opt) => (
+ *           <button onClick={() => vote([opt.id])} disabled={hasVoted()}>
+ *             {opt.text} ({p().results[opt.id] || 0} votes)
+ *           </button>
+ *         )}
+ *       </For>
+ *     </div>
+ *   )}
+ * </Show>
+ * ```
+ */
+export declare function createPoll(options: CreatePollOptions): CreatePollReturn;
+export interface CreateAnnouncementsOptions extends OptionalSiteKey<SeriphConfig> {
+    /** Auto-fetch announcements on mount (default: true) */
+    autoFetch?: boolean;
+}
+export interface CreateAnnouncementsReturn {
+    announcements: Accessor<Announcement[]>;
+    status: Accessor<ControllerStatus>;
+    error: Accessor<Error | null>;
+    dismiss: (announcementId: number) => Promise<void>;
+    refresh: () => Promise<void>;
+}
+/**
+ * Primitive for displaying site announcements.
+ *
+ * @example
+ * ```tsx
+ * // With meta tag: <meta name="seriph-site-key" content="your-key" />
+ * const { announcements, dismiss } = createAnnouncements({});
+ *
+ * <For each={announcements()}>
+ *   {(ann) => (
+ *     <div class={`announcement-${ann.announcementType}`}>
+ *       {ann.content}
+ *       {ann.isDismissible && (
+ *         <button onClick={() => dismiss(ann.id)}>Dismiss</button>
+ *       )}
+ *     </div>
+ *   )}
+ * </For>
+ * ```
+ */
+export declare function createAnnouncements(options: CreateAnnouncementsOptions): CreateAnnouncementsReturn;
 //# 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

@@ -30,26 +30,28 @@
  * ```
  */
 import { createSignal, createEffect, onCleanup } from "solid-js";
-import { SubscribeController, FormController, ReactionsController, CommentsController, } from "@seriphxyz/core";
-// Re-export API functions from core
-export { fetchPosts, fetchPost, DEFAULT_ENDPOINT, API_PATH, } from "@seriphxyz/core";
+import { SubscribeController, FormController, ReactionsController, CommentsController, WaitlistController, ViewCountsController, FeedbackController, PollController, AnnouncementsController, resolveConfig, } from "@seriphxyz/core";
+// Re-export API functions and helpers from core
+export { fetchPosts, fetchPost, getConfigFromMeta, resolveConfig, DEFAULT_ENDPOINT, API_PATH, } from "@seriphxyz/core";
 /**
  * Primitive for handling email subscriptions.
  *
  * @example
  * ```tsx
- * const { subscribe, status, message, error } = createSubscribe({
- *   siteKey: 'your-site-key',
- * });
+ * // With explicit siteKey:
+ * const { subscribe, status } = createSubscribe({ siteKey: 'your-key' });
  *
- * <button onClick={() => subscribe('user@example.com')}>Subscribe</button>
+ * // Or with meta tag (add to document head):
+ * // <meta name="seriph-site-key" content="your-key" />
+ * const { subscribe, status } = createSubscribe({});
  * ```
  */
 export function createSubscribe(options) {
     const [status, setStatus] = createSignal("idle");
     const [message, setMessage] = createSignal(null);
     const [error, setError] = createSignal(null);
-    const controller = new SubscribeController(options);
+    const config = resolveConfig(options);
+    const controller = new SubscribeController(config);
     createEffect(() => {
         const unsubscribe = controller.subscribe((state) => {
             setStatus(state.status);
@@ -72,7 +74,7 @@ export function createSubscribe(options) {
  * @example
  * ```tsx
  * const { submit, status, error } = createForm({
- *   siteKey: 'your-site-key',
+ *   siteKey: 'your-site-key', // optional with meta tag
  *   formSlug: 'contact',
  * });
  *
@@ -87,7 +89,8 @@ export function createForm(options) {
     const [status, setStatus] = createSignal("idle");
     const [message, setMessage] = createSignal(null);
     const [error, setError] = createSignal(null);
-    const controller = new FormController(options, options.formSlug);
+    const config = resolveConfig(options);
+    const controller = new FormController(config, options.formSlug);
     createEffect(() => {
         const unsubscribe = controller.subscribe((state) => {
             setStatus(state.status);
@@ -110,7 +113,6 @@ export function createForm(options) {
  * @example
  * ```tsx
  * const { counts, userReactions, addReaction, removeReaction } = createReactions({
- *   siteKey: 'your-site-key',
  *   contentId: 'my-post-slug',
  * });
  *
@@ -124,7 +126,8 @@ export function createReactions(options) {
     const [userReactions, setUserReactions] = createSignal([]);
     const [status, setStatus] = createSignal("idle");
     const [error, setError] = createSignal(null);
-    const controller = new ReactionsController(options, options.contentId);
+    const config = resolveConfig(options);
+    const controller = new ReactionsController(config, options.contentId);
     createEffect(() => {
         const unsubscribe = controller.subscribe((state) => {
             setCounts(state.counts);
@@ -155,7 +158,6 @@ export function createReactions(options) {
  * @example
  * ```tsx
  * const { comments, status, postComment } = createComments({
- *   siteKey: 'your-site-key',
  *   contentId: 'my-post-slug',
  * });
  *
@@ -176,7 +178,8 @@ export function createComments(options) {
     const [comments, setComments] = createSignal([]);
     const [status, setStatus] = createSignal("idle");
     const [error, setError] = createSignal(null);
-    const controller = new CommentsController(options, options.contentId);
+    const config = resolveConfig(options);
+    const controller = new CommentsController(config, options.contentId);
     createEffect(() => {
         const unsubscribe = controller.subscribe((state) => {
             setComments(state.comments);
@@ -197,3 +200,210 @@ export function createComments(options) {
     };
     return { comments, status, error, postComment, refresh };
 }
+/**
+ * Primitive for handling waitlist signups.
+ *
+ * @example
+ * ```tsx
+ * const { join, status, position } = createWaitlist({});
+ *
+ * <button onClick={() => join('user@example.com')}>Join Waitlist</button>
+ * {status() === 'success' && <p>You're #{position()} on the list!</p>}
+ * ```
+ */
+export function createWaitlist(options) {
+    const [status, setStatus] = createSignal("idle");
+    const [message, setMessage] = createSignal(null);
+    const [position, setPosition] = createSignal(null);
+    const [error, setError] = createSignal(null);
+    const config = resolveConfig(options);
+    const controller = new WaitlistController(config);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            setStatus(state.status);
+            setMessage(state.message);
+            setPosition(state.position);
+            setError(state.error);
+        });
+        onCleanup(unsubscribe);
+    });
+    const join = async (email, opts) => {
+        await controller.join(email, opts);
+    };
+    const reset = () => {
+        controller.reset();
+    };
+    return { status, message, position, error, join, reset };
+}
+/**
+ * Primitive for tracking and displaying page views.
+ *
+ * @example
+ * ```tsx
+ * const { views, uniqueVisitors } = createViews({
+ *   pageId: '/blog/my-post',
+ * });
+ *
+ * <span>{views()} views ({uniqueVisitors()} unique)</span>
+ * ```
+ */
+export function createViews(options) {
+    const [views, setViews] = createSignal(0);
+    const [uniqueVisitors, setUniqueVisitors] = createSignal(0);
+    const [status, setStatus] = createSignal("idle");
+    const [error, setError] = createSignal(null);
+    const config = resolveConfig(options);
+    const controller = new ViewCountsController(config, options.pageId);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            setViews(state.views);
+            setUniqueVisitors(state.uniqueVisitors);
+            setStatus(state.status);
+            setError(state.error);
+        });
+        // Auto-record view on mount (default: true)
+        if (options.autoRecord !== false) {
+            controller.record();
+        }
+        onCleanup(unsubscribe);
+    });
+    const record = async () => {
+        await controller.record();
+    };
+    const refresh = async () => {
+        await controller.fetch();
+    };
+    return { views, uniqueVisitors, status, error, record, refresh };
+}
+/**
+ * Primitive for handling feedback submissions.
+ *
+ * @example
+ * ```tsx
+ * const { submit, status } = createFeedback({});
+ *
+ * <button onClick={() => submit('feature', 'Add dark mode!')}>
+ *   Submit Feedback
+ * </button>
+ * ```
+ */
+export function createFeedback(options) {
+    const [status, setStatus] = createSignal("idle");
+    const [message, setMessage] = createSignal(null);
+    const [error, setError] = createSignal(null);
+    const config = resolveConfig(options);
+    const controller = new FeedbackController(config);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            setStatus(state.status);
+            setMessage(state.message);
+            setError(state.error);
+        });
+        onCleanup(unsubscribe);
+    });
+    const submit = async (type, content, opts) => {
+        await controller.submit(type, content, opts);
+    };
+    const reset = () => {
+        controller.reset();
+    };
+    return { status, message, error, submit, reset };
+}
+/**
+ * Primitive for displaying and voting on polls.
+ *
+ * @example
+ * ```tsx
+ * // With meta tag: <meta name="seriph-site-key" content="your-key" />
+ * const { poll, vote, hasVoted } = createPoll({ slug: 'favorite-framework' });
+ *
+ * <Show when={poll()}>
+ *   {(p) => (
+ *     <div>
+ *       <h3>{p().question}</h3>
+ *       <For each={p().options}>
+ *         {(opt) => (
+ *           <button onClick={() => vote([opt.id])} disabled={hasVoted()}>
+ *             {opt.text} ({p().results[opt.id] || 0} votes)
+ *           </button>
+ *         )}
+ *       </For>
+ *     </div>
+ *   )}
+ * </Show>
+ * ```
+ */
+export function createPoll(options) {
+    const [poll, setPoll] = createSignal(null);
+    const [status, setStatus] = createSignal("idle");
+    const [error, setError] = createSignal(null);
+    const config = resolveConfig(options);
+    const controller = new PollController(config, options.slug);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            setPoll(state.poll);
+            setStatus(state.status);
+            setError(state.error);
+        });
+        // Auto-fetch on mount (default: true)
+        if (options.autoFetch !== false) {
+            controller.fetch();
+        }
+        onCleanup(unsubscribe);
+    });
+    const vote = async (selectedOptions) => {
+        await controller.vote(selectedOptions);
+    };
+    const refresh = async () => {
+        await controller.fetch();
+    };
+    const hasVoted = () => controller.hasVoted();
+    return { poll, status, error, vote, hasVoted, refresh };
+}
+/**
+ * Primitive for displaying site announcements.
+ *
+ * @example
+ * ```tsx
+ * // With meta tag: <meta name="seriph-site-key" content="your-key" />
+ * const { announcements, dismiss } = createAnnouncements({});
+ *
+ * <For each={announcements()}>
+ *   {(ann) => (
+ *     <div class={`announcement-${ann.announcementType}`}>
+ *       {ann.content}
+ *       {ann.isDismissible && (
+ *         <button onClick={() => dismiss(ann.id)}>Dismiss</button>
+ *       )}
+ *     </div>
+ *   )}
+ * </For>
+ * ```
+ */
+export function createAnnouncements(options) {
+    const [announcements, setAnnouncements] = createSignal([]);
+    const [status, setStatus] = createSignal("idle");
+    const [error, setError] = createSignal(null);
+    const config = resolveConfig(options);
+    const controller = new AnnouncementsController(config);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            // Only show non-dismissed announcements
+            setAnnouncements(controller.getVisibleAnnouncements());
+            setStatus(state.status);
+            setError(state.error);
+        });
+        // Auto-fetch on mount (default: true)
+        if (options.autoFetch !== false) {
+            controller.fetch();
+        }
+        onCleanup(unsubscribe);
+    });
+    const dismiss = async (announcementId) => {
+        await controller.dismiss(announcementId);
+    };
+    const refresh = async () => {
+        await controller.fetch();
+    };
+    return { announcements, status, error, dismiss, refresh };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seriphxyz/solid",
-  "version": "0.1.7",
+  "version": "0.1.10",
   "description": "SolidJS primitives for Seriph widgets (forms, comments, reactions, subscriptions)",
   "repository": {
     "type": "git",
@@ -32,7 +32,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@seriphxyz/core": "0.1.7"
+    "@seriphxyz/core": "0.1.10"
   },
   "peerDependencies": {
     "solid-js": "^1.8.0"