@seriphxyz/react 0.1.2 → 0.1.7

package/README.md

@@ -0,0 +1,288 @@
+# @seriphxyz/react
+
+> **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.
+
+React hooks for [Seriph](https://seriph.xyz) widgets - comments, reactions, forms, subscriptions, and more.
+
+## Installation
+
+```bash
+npm install @seriphxyz/react
+```
+
+Works with React 18+ and React 19. Compatible with Next.js, Remix, Vite, and more.
+
+## Hooks
+
+### useSubscribe
+
+Email subscription form:
+
+```tsx
+import { useSubscribe } from "@seriphxyz/react";
+
+function SubscribeForm() {
+  const [email, setEmail] = useState("");
+  const { submit, status, message, error } = useSubscribe({
+    siteKey: "your-key",
+  });
+
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+    await submit(email);
+  };
+
+  return (
+    <form onSubmit={handleSubmit}>
+      <input
+        type="email"
+        value={email}
+        onChange={(e) => setEmail(e.target.value)}
+        placeholder="your@email.com"
+      />
+      <button disabled={status === "loading"}>
+        {status === "loading" ? "Subscribing..." : "Subscribe"}
+      </button>
+      {status === "success" && <p>{message}</p>}
+      {status === "error" && <p>{error?.message}</p>}
+    </form>
+  );
+}
+```
+
+### useReactions
+
+Reaction buttons (like, love, clap, etc.):
+
+```tsx
+import { useReactions } from "@seriphxyz/react";
+
+function LikeButton() {
+  const { counts, userReactions, add, remove, status } = useReactions({
+    siteKey: "your-key",
+    pageId: "my-page",
+  });
+
+  const hasLiked = userReactions.includes("like");
+
+  return (
+    <button onClick={() => (hasLiked ? remove("like") : add("like"))}>
+      {hasLiked ? "Unlike" : "Like"} ({counts.like || 0})
+    </button>
+  );
+}
+```
+
+### useComments
+
+Threaded comments:
+
+```tsx
+import { useComments } from "@seriphxyz/react";
+
+function Comments() {
+  const { comments, post, status, error } = useComments({
+    siteKey: "your-key",
+    pageId: "my-page",
+  });
+
+  const handleSubmit = async (name, content) => {
+    await post(name, content);
+  };
+
+  return (
+    <div>
+      {comments.map((comment) => (
+        <div key={comment.id}>
+          <strong>{comment.authorName}</strong>
+          <p>{comment.content}</p>
+        </div>
+      ))}
+    </div>
+  );
+}
+```
+
+### useForm
+
+Contact forms with spam protection:
+
+```tsx
+import { useForm } from "@seriphxyz/react";
+
+function ContactForm() {
+  const { submit, status, message } = useForm({
+    siteKey: "your-key",
+    formSlug: "contact",
+  });
+
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+    const data = Object.fromEntries(new FormData(e.target));
+    await submit(data);
+  };
+
+  return (
+    <form onSubmit={handleSubmit}>
+      <input name="email" type="email" required />
+      <textarea name="message" required />
+      <button type="submit">Send</button>
+      {status === "success" && <p>{message}</p>}
+    </form>
+  );
+}
+```
+
+### useWaitlist
+
+Waitlist signups:
+
+```tsx
+import { useWaitlist } from "@seriphxyz/react";
+
+function WaitlistForm() {
+  const { join, status, message, position } = useWaitlist({
+    siteKey: "your-key",
+  });
+
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+    await join(email, { name, source: "homepage" });
+  };
+
+  return (
+    <form onSubmit={handleSubmit}>
+      <input name="email" type="email" required />
+      <button type="submit">Join Waitlist</button>
+      {status === "success" && <p>{message}</p>}
+    </form>
+  );
+}
+```
+
+### useFeedback
+
+Feedback forms:
+
+```tsx
+import { useFeedback } from "@seriphxyz/react";
+
+function FeedbackWidget() {
+  const { submit, status, message } = useFeedback({
+    siteKey: "your-key",
+  });
+
+  const handleSubmit = async (type, content) => {
+    await submit(type, content, { email, pageUrl: window.location.href });
+  };
+
+  // ...
+}
+```
+
+### usePoll
+
+Polls and voting:
+
+```tsx
+import { usePoll } from "@seriphxyz/react";
+
+function Poll() {
+  const { poll, vote, hasVoted, status } = usePoll({
+    siteKey: "your-key",
+    pollId: 123,
+  });
+
+  if (!poll) return <div>Loading...</div>;
+
+  return (
+    <div>
+      <h3>{poll.question}</h3>
+      {poll.options.map((option) => (
+        <button
+          key={option.id}
+          onClick={() => vote([option.id])}
+          disabled={hasVoted}
+        >
+          {option.text} ({poll.results?.[option.id] || 0})
+        </button>
+      ))}
+    </div>
+  );
+}
+```
+
+### useAnnouncements
+
+Site announcements:
+
+```tsx
+import { useAnnouncements } from "@seriphxyz/react";
+
+function AnnouncementBanner() {
+  const { announcements, dismiss, status } = useAnnouncements({
+    siteKey: "your-key",
+  });
+
+  const visible = announcements.filter((a) => !a.dismissed);
+
+  return (
+    <>
+      {visible.map((announcement) => (
+        <div key={announcement.id}>
+          <p>{announcement.content}</p>
+          {announcement.isDismissible && (
+            <button onClick={() => dismiss(announcement.id)}>Dismiss</button>
+          )}
+        </div>
+      ))}
+    </>
+  );
+}
+```
+
+### useViewCounts
+
+Page view tracking:
+
+```tsx
+import { useViewCounts } from "@seriphxyz/react";
+import { useEffect } from "react";
+
+function PageViews() {
+  const { views, uniqueVisitors, record, status } = useViewCounts({
+    siteKey: "your-key",
+    pageId: "my-page",
+  });
+
+  // Record view on mount
+  useEffect(() => {
+    record();
+  }, []);
+
+  return (
+    <span>
+      {views} views ({uniqueVisitors} unique)
+    </span>
+  );
+}
+```
+
+## All Hooks
+
+| Hook | Purpose |
+|------|---------|
+| `useSubscribe` | Email subscriptions |
+| `useReactions` | Page reactions |
+| `useComments` | Threaded comments |
+| `useForm` | Form submissions |
+| `useWaitlist` | Waitlist signups |
+| `useFeedback` | Feedback forms |
+| `usePoll` | Polls and voting |
+| `useAnnouncements` | Site announcements |
+| `useViewCounts` | Page view tracking |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -124,7 +124,10 @@ export interface UseCommentsReturn {
     comments: Comment[];
     status: ControllerStatus;
     error: Error | null;
-    postComment: (author: string, content: string) => Promise<void>;
+    postComment: (author: string, content: string, options?: {
+        authorEmail?: string;
+        parentId?: string;
+    }) => Promise<void>;
     refresh: () => Promise<void>;
 }
 /**

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

@@ -186,8 +186,8 @@ export function useComments(options) {
         }
         return unsubscribe;
     }, [options.siteKey, options.endpoint, options.contentId]);
-    const postComment = useCallback(async (author, content) => {
-        await controllerRef.current?.post(author, content);
+    const postComment = useCallback(async (author, content, options) => {
+        await controllerRef.current?.post(author, content, options);
     }, []);
     const refresh = useCallback(async () => {
         await controllerRef.current?.fetch();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seriphxyz/react",
-  "version": "0.1.2",
+  "version": "0.1.7",
   "description": "React hooks for Seriph widgets (forms, comments, reactions, subscriptions)",
   "repository": {
     "type": "git",
@@ -31,7 +31,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@seriphxyz/core": "0.1.2"
+    "@seriphxyz/core": "0.1.7"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"