@jamwidgets/astro 0.1.0

package/src/index.ts

@@ -0,0 +1,127 @@
+/**
+ * @jamwidgets/astro
+ *
+ * Astro components and content loader for Jamwidgets.
+ * Re-exports all types, API functions, and controllers from @jamwidgets/core.
+ */
+
+// Re-export everything from core
+export {
+  // Constants
+  DEFAULT_ENDPOINT,
+  API_PATH,
+  VISITOR_STORAGE_KEY,
+
+  // Types
+  type JamWidgetsConfig,
+  type SeriphConfig, // deprecated alias
+  type Comment,
+  type ReactionCounts,
+  type FormSubmitResponse,
+  type SubscribeResponse,
+  type JamwidgetsPost,
+  type SeriphPost, // deprecated alias
+  type Announcement,
+  type AnnouncementType,
+  type Poll,
+  type PollOption,
+  type PollSettings,
+  type PollWithResults,
+  type ShowResultsMode,
+  type FeedbackType,
+
+  // Helpers
+  buildUrl,
+  getSiteKey,
+  getVisitorId,
+  setVisitorId,
+
+  // API Functions - Forms
+  type SubmitFormOptions,
+  submitForm,
+
+  // API Functions - Comments
+  type FetchCommentsOptions,
+  fetchComments,
+  type PostCommentOptions,
+  postComment,
+
+  // API Functions - Reactions
+  type FetchReactionsOptions,
+  type FetchReactionsResponse,
+  fetchReactions,
+  type AddReactionOptions,
+  addReaction,
+  type RemoveReactionOptions,
+  removeReaction,
+
+  // API Functions - Subscriptions
+  type SubscribeOptions,
+  subscribe,
+
+  // API Functions - Waitlist
+  type JoinWaitlistOptions,
+  type JoinWaitlistResponse,
+  joinWaitlist,
+
+  // API Functions - Views
+  type ViewCountsOptions,
+  type ViewCounts,
+  type RecordViewResponse,
+  getViewCounts,
+  recordView,
+
+  // API Functions - Feedback
+  type SubmitFeedbackOptions,
+  type SubmitFeedbackResponse,
+  submitFeedback,
+
+  // API Functions - Polls
+  type FetchPollOptions,
+  fetchPoll,
+  type VotePollOptions,
+  type VotePollResponse,
+  votePoll,
+
+  // API Functions - Announcements
+  type FetchAnnouncementsOptions,
+  fetchAnnouncements,
+  type DismissAnnouncementOptions,
+  dismissAnnouncement,
+
+  // API Functions - Posts
+  type FetchPostsOptions,
+  fetchPosts,
+  type FetchPostOptions,
+  fetchPost,
+
+  // Controllers
+  type ControllerStatus,
+  type ControllerListener,
+  type SubscribeState,
+  type FormState,
+  type ReactionsState,
+  type CommentsState,
+  type WaitlistState,
+  type ViewCountsState,
+  type FeedbackState,
+  type PollState,
+  type AnnouncementsState,
+  SubscribeController,
+  WaitlistController,
+  FormController,
+  ReactionsController,
+  CommentsController,
+  ViewCountsController,
+  FeedbackController,
+  PollController,
+  AnnouncementsController,
+} from "@jamwidgets/core";
+
+// Re-export loader (Astro-specific)
+export {
+  jamwidgetsPostsLoader,
+  seriphPostsLoader, // deprecated alias
+  type JamwidgetsPostsLoaderOptions,
+  type SeriphPostsLoaderOptions, // deprecated alias
+} from "./loader.js";

package/src/loader.ts

@@ -0,0 +1,141 @@
+/**
+ * Astro Content Loader for Jamwidgets Posts
+ *
+ * Use this loader to fetch posts from your Jamwidgets instance at build time.
+ *
+ * @example
+ * // In src/content.config.ts
+ * import { defineCollection } from 'astro:content';
+ * import { jamwidgetsPostsLoader } from '@jamwidgets/astro/loader';
+ *
+ * const posts = defineCollection({
+ *   loader: jamwidgetsPostsLoader({
+ *     siteKey: import.meta.env.JAMWIDGETS_SITE_KEY,
+ *   }),
+ * });
+ *
+ * export const collections = { posts };
+ */
+
+import {
+  DEFAULT_ENDPOINT,
+  API_PATH,
+  getSiteKey,
+  fetchPosts as coreFetchPosts,
+  fetchPost as coreFetchPost,
+  type JamwidgetsPost,
+  type SeriphPost, // deprecated alias
+  type FetchPostsOptions,
+  type FetchPostOptions,
+} from "@jamwidgets/core";
+
+// Re-export types and functions from core
+export type { JamwidgetsPost, SeriphPost, FetchPostsOptions, FetchPostOptions };
+export { coreFetchPosts as fetchPosts, coreFetchPost as fetchPost };
+
+export interface JamwidgetsPostsLoaderOptions {
+  /** Your site key (required) */
+  siteKey: string;
+  /** Base URL of your Jamwidgets instance (default: 'https://jamwidgets.com') */
+  endpoint?: string;
+  /** Filter posts by tag */
+  tag?: string;
+  /** Maximum number of posts to fetch (default: 500) */
+  limit?: number;
+  /** How to handle errors: 'throw' (default), 'warn', or 'ignore' */
+  onError?: "throw" | "warn" | "ignore";
+}
+
+/** @deprecated Use JamwidgetsPostsLoaderOptions instead */
+export type SeriphPostsLoaderOptions = JamwidgetsPostsLoaderOptions;
+
+interface LoaderContext {
+  store: {
+    set: (entry: { id: string; data: JamwidgetsPost }) => void;
+    clear: () => void;
+  };
+  logger: {
+    info: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+  };
+  generateDigest: (data: unknown) => string;
+}
+
+interface ApiResponse {
+  posts: JamwidgetsPost[];
+  total: number;
+}
+
+/**
+ * Creates an Astro content loader that fetches posts from Jamwidgets.
+ *
+ * Posts are fetched at build time and cached by Astro.
+ */
+export function jamwidgetsPostsLoader(options: JamwidgetsPostsLoaderOptions) {
+  const {
+    endpoint = DEFAULT_ENDPOINT,
+    tag,
+    limit = 500,
+    onError = "throw",
+  } = options;
+
+  const siteKey = getSiteKey({ siteKey: options.siteKey });
+  const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
+
+  return {
+    name: "jamwidgets-posts-loader",
+
+    async load(context: LoaderContext) {
+      const { store, logger } = context;
+
+      try {
+        const url = new URL(`${baseUrl}/posts`);
+        url.searchParams.set("limit", String(limit));
+        if (tag) {
+          url.searchParams.set("tag", tag);
+        }
+
+        logger.info(`Fetching posts from ${url.toString()}`);
+
+        const response = await fetch(url.toString(), {
+          headers: {
+            "X-Jamwidgets-Key": siteKey,
+            "X-JamWidgets-Key": siteKey, // backward compat
+          },
+        });
+
+        if (!response.ok) {
+          throw new Error(
+            `Failed to fetch posts: ${response.status} ${response.statusText}`,
+          );
+        }
+
+        const data: ApiResponse = await response.json();
+
+        store.clear();
+
+        for (const post of data.posts) {
+          store.set({
+            id: post.slug,
+            data: post,
+          });
+        }
+
+        logger.info(`Loaded ${data.posts.length} posts from Jamwidgets`);
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+
+        if (onError === "throw") {
+          logger.error(`Error loading posts: ${message}`);
+          throw error;
+        } else if (onError === "warn") {
+          logger.warn(`Error loading posts (continuing anyway): ${message}`);
+        }
+      }
+    },
+  };
+}
+
+/** @deprecated Use jamwidgetsPostsLoader instead */
+export const seriphPostsLoader = jamwidgetsPostsLoader;