@seriphxyz/solid 0.1.2

package/dist/index.d.ts

@@ -0,0 +1,155 @@
+/**
+ * @seriphxyz/solid - SolidJS primitives for Seriph widgets
+ *
+ * @example Subscribe form
+ * ```tsx
+ * import { createSubscribe } from '@seriphxyz/solid';
+ *
+ * function Newsletter() {
+ *   const { subscribe, status, error } = createSubscribe({
+ *     siteKey: 'your-site-key',
+ *   });
+ *
+ *   const handleSubmit = (e: SubmitEvent) => {
+ *     e.preventDefault();
+ *     const email = new FormData(e.currentTarget as HTMLFormElement).get('email') as string;
+ *     subscribe(email);
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input type="email" name="email" required />
+ *       <button disabled={status() === 'loading'}>
+ *         {status() === 'loading' ? 'Subscribing...' : 'Subscribe'}
+ *       </button>
+ *       {status() === 'success' && <p>Thanks for subscribing!</p>}
+ *       {status() === 'error' && <p>Error: {error()?.message}</p>}
+ *     </form>
+ *   );
+ * }
+ * ```
+ */
+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 {
+}
+export interface CreateSubscribeReturn {
+    status: Accessor<ControllerStatus>;
+    message: Accessor<string | null>;
+    error: Accessor<Error | null>;
+    subscribe: (email: string) => Promise<void>;
+    reset: () => void;
+}
+/**
+ * Primitive for handling email subscriptions.
+ *
+ * @example
+ * ```tsx
+ * const { subscribe, status, message, error } = createSubscribe({
+ *   siteKey: 'your-site-key',
+ * });
+ *
+ * <button onClick={() => subscribe('user@example.com')}>Subscribe</button>
+ * ```
+ */
+export declare function createSubscribe(options: CreateSubscribeOptions): CreateSubscribeReturn;
+export interface CreateFormOptions extends SeriphConfig {
+    /** Form slug/identifier */
+    formSlug: string;
+}
+export interface CreateFormReturn {
+    status: Accessor<ControllerStatus>;
+    message: Accessor<string | null>;
+    error: Accessor<Error | null>;
+    submit: (data: Record<string, unknown>) => Promise<void>;
+    reset: () => void;
+}
+/**
+ * Primitive for handling form submissions.
+ *
+ * @example
+ * ```tsx
+ * const { submit, status, error } = createForm({
+ *   siteKey: 'your-site-key',
+ *   formSlug: 'contact',
+ * });
+ *
+ * const handleSubmit = (e: SubmitEvent) => {
+ *   e.preventDefault();
+ *   const formData = new FormData(e.currentTarget as HTMLFormElement);
+ *   submit(Object.fromEntries(formData));
+ * };
+ * ```
+ */
+export declare function createForm(options: CreateFormOptions): CreateFormReturn;
+export interface CreateReactionsOptions extends SeriphConfig {
+    /** Content identifier (e.g., post slug) */
+    contentId: string;
+    /** Auto-fetch reactions on mount (default: true) */
+    autoFetch?: boolean;
+}
+export interface CreateReactionsReturn {
+    counts: Accessor<Record<string, number>>;
+    userReactions: Accessor<string[]>;
+    status: Accessor<ControllerStatus>;
+    error: Accessor<Error | null>;
+    addReaction: (type: string) => Promise<void>;
+    removeReaction: (type: string) => Promise<void>;
+    refresh: () => Promise<void>;
+}
+/**
+ * Primitive for handling reactions (likes, claps, etc.).
+ *
+ * @example
+ * ```tsx
+ * const { counts, userReactions, addReaction, removeReaction } = createReactions({
+ *   siteKey: 'your-site-key',
+ *   contentId: 'my-post-slug',
+ * });
+ *
+ * <button onClick={() => addReaction('like')}>
+ *   Like ({counts().like || 0})
+ * </button>
+ * ```
+ */
+export declare function createReactions(options: CreateReactionsOptions): CreateReactionsReturn;
+export interface CreateCommentsOptions extends SeriphConfig {
+    /** Content identifier (e.g., post slug) */
+    contentId: string;
+    /** Auto-fetch comments on mount (default: true) */
+    autoFetch?: boolean;
+}
+export interface CreateCommentsReturn {
+    comments: Accessor<Comment[]>;
+    status: Accessor<ControllerStatus>;
+    error: Accessor<Error | null>;
+    postComment: (author: string, content: string) => Promise<void>;
+    refresh: () => Promise<void>;
+}
+/**
+ * Primitive for handling comments.
+ *
+ * @example
+ * ```tsx
+ * const { comments, status, postComment } = createComments({
+ *   siteKey: 'your-site-key',
+ *   contentId: 'my-post-slug',
+ * });
+ *
+ * <For each={comments()}>
+ *   {(comment) => (
+ *     <div>
+ *       <strong>{comment.authorName}</strong>: {comment.content}
+ *     </div>
+ *   )}
+ * </For>
+ *
+ * <button onClick={() => postComment('Anonymous', 'Great post!')}>
+ *   Add Comment
+ * </button>
+ * ```
+ */
+export declare function createComments(options: CreateCommentsOptions): CreateCommentsReturn;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,199 @@
+/**
+ * @seriphxyz/solid - SolidJS primitives for Seriph widgets
+ *
+ * @example Subscribe form
+ * ```tsx
+ * import { createSubscribe } from '@seriphxyz/solid';
+ *
+ * function Newsletter() {
+ *   const { subscribe, status, error } = createSubscribe({
+ *     siteKey: 'your-site-key',
+ *   });
+ *
+ *   const handleSubmit = (e: SubmitEvent) => {
+ *     e.preventDefault();
+ *     const email = new FormData(e.currentTarget as HTMLFormElement).get('email') as string;
+ *     subscribe(email);
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input type="email" name="email" required />
+ *       <button disabled={status() === 'loading'}>
+ *         {status() === 'loading' ? 'Subscribing...' : 'Subscribe'}
+ *       </button>
+ *       {status() === 'success' && <p>Thanks for subscribing!</p>}
+ *       {status() === 'error' && <p>Error: {error()?.message}</p>}
+ *     </form>
+ *   );
+ * }
+ * ```
+ */
+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";
+/**
+ * Primitive for handling email subscriptions.
+ *
+ * @example
+ * ```tsx
+ * const { subscribe, status, message, error } = createSubscribe({
+ *   siteKey: 'your-site-key',
+ * });
+ *
+ * <button onClick={() => subscribe('user@example.com')}>Subscribe</button>
+ * ```
+ */
+export function createSubscribe(options) {
+    const [status, setStatus] = createSignal("idle");
+    const [message, setMessage] = createSignal(null);
+    const [error, setError] = createSignal(null);
+    const controller = new SubscribeController(options);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            setStatus(state.status);
+            setMessage(state.message);
+            setError(state.error);
+        });
+        onCleanup(unsubscribe);
+    });
+    const subscribe = async (email) => {
+        await controller.submit(email);
+    };
+    const reset = () => {
+        controller.reset();
+    };
+    return { status, message, error, subscribe, reset };
+}
+/**
+ * Primitive for handling form submissions.
+ *
+ * @example
+ * ```tsx
+ * const { submit, status, error } = createForm({
+ *   siteKey: 'your-site-key',
+ *   formSlug: 'contact',
+ * });
+ *
+ * const handleSubmit = (e: SubmitEvent) => {
+ *   e.preventDefault();
+ *   const formData = new FormData(e.currentTarget as HTMLFormElement);
+ *   submit(Object.fromEntries(formData));
+ * };
+ * ```
+ */
+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);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            setStatus(state.status);
+            setMessage(state.message);
+            setError(state.error);
+        });
+        onCleanup(unsubscribe);
+    });
+    const submit = async (data) => {
+        await controller.submit(data);
+    };
+    const reset = () => {
+        controller.reset();
+    };
+    return { status, message, error, submit, reset };
+}
+/**
+ * Primitive for handling reactions (likes, claps, etc.).
+ *
+ * @example
+ * ```tsx
+ * const { counts, userReactions, addReaction, removeReaction } = createReactions({
+ *   siteKey: 'your-site-key',
+ *   contentId: 'my-post-slug',
+ * });
+ *
+ * <button onClick={() => addReaction('like')}>
+ *   Like ({counts().like || 0})
+ * </button>
+ * ```
+ */
+export function createReactions(options) {
+    const [counts, setCounts] = createSignal({});
+    const [userReactions, setUserReactions] = createSignal([]);
+    const [status, setStatus] = createSignal("idle");
+    const [error, setError] = createSignal(null);
+    const controller = new ReactionsController(options, options.contentId);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            setCounts(state.counts);
+            setUserReactions(state.userReactions);
+            setStatus(state.status);
+            setError(state.error);
+        });
+        // Auto-fetch on mount (default: true)
+        if (options.autoFetch !== false) {
+            controller.fetch();
+        }
+        onCleanup(unsubscribe);
+    });
+    const addReaction = async (type) => {
+        await controller.add(type);
+    };
+    const removeReaction = async (type) => {
+        await controller.remove(type);
+    };
+    const refresh = async () => {
+        await controller.fetch();
+    };
+    return { counts, userReactions, status, error, addReaction, removeReaction, refresh };
+}
+/**
+ * Primitive for handling comments.
+ *
+ * @example
+ * ```tsx
+ * const { comments, status, postComment } = createComments({
+ *   siteKey: 'your-site-key',
+ *   contentId: 'my-post-slug',
+ * });
+ *
+ * <For each={comments()}>
+ *   {(comment) => (
+ *     <div>
+ *       <strong>{comment.authorName}</strong>: {comment.content}
+ *     </div>
+ *   )}
+ * </For>
+ *
+ * <button onClick={() => postComment('Anonymous', 'Great post!')}>
+ *   Add Comment
+ * </button>
+ * ```
+ */
+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);
+    createEffect(() => {
+        const unsubscribe = controller.subscribe((state) => {
+            setComments(state.comments);
+            setStatus(state.status);
+            setError(state.error);
+        });
+        // Auto-fetch on mount (default: true)
+        if (options.autoFetch !== false) {
+            controller.fetch();
+        }
+        onCleanup(unsubscribe);
+    });
+    const postComment = async (author, content) => {
+        await controller.post(author, content);
+    };
+    const refresh = async () => {
+        await controller.fetch();
+    };
+    return { comments, status, error, postComment, refresh };
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@seriphxyz/solid",
+  "version": "0.1.2",
+  "description": "SolidJS primitives for Seriph widgets (forms, comments, reactions, subscriptions)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/seriphxyz/solid.git"
+  },
+  "homepage": "https://seriph.xyz",
+  "author": "Tim Shedor",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "solid",
+    "solidjs",
+    "seriph",
+    "forms",
+    "comments",
+    "reactions",
+    "subscribe",
+    "primitives"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@seriphxyz/core": "0.1.2"
+  },
+  "peerDependencies": {
+    "solid-js": "^1.8.0"
+  },
+  "devDependencies": {
+    "solid-js": "^1.9.0",
+    "typescript": "^5.7.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}