@jamwidgets/astro 0.1.1 → 0.3.1

package/dist/index.d.ts

@@ -6,6 +6,6 @@
  */
 export { DEFAULT_ENDPOINT, API_PATH, VISITOR_STORAGE_KEY, 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, buildUrl, getSiteKey, getVisitorId, setVisitorId, type SubmitFormOptions, submitForm, type FetchCommentsOptions, fetchComments, type PostCommentOptions, postComment, type FetchReactionsOptions, type FetchReactionsResponse, fetchReactions, type AddReactionOptions, addReaction, type RemoveReactionOptions, removeReaction, type SubscribeOptions, subscribe, type JoinWaitlistOptions, type JoinWaitlistResponse, joinWaitlist, type ViewCountsOptions, type ViewCounts, type RecordViewResponse, getViewCounts, recordView, type SubmitFeedbackOptions, type SubmitFeedbackResponse, submitFeedback, type FetchPollOptions, fetchPoll, type VotePollOptions, type VotePollResponse, votePoll, type FetchAnnouncementsOptions, fetchAnnouncements, type DismissAnnouncementOptions, dismissAnnouncement, type FetchPostsOptions, fetchPosts, type FetchPostOptions, fetchPost, 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";
+type Announcement, type AnnouncementType, type Poll, type PollOption, type PollSettings, type PollWithResults, type ShowResultsMode, type FeedbackType, buildUrl, getSiteKey, getVisitorId, setVisitorId, type SubmitFormOptions, submitForm, type FetchCommentsOptions, fetchComments, type PostCommentOptions, postComment, type FetchReactionsOptions, type FetchReactionsResponse, fetchReactions, type AddReactionOptions, addReaction, type RemoveReactionOptions, removeReaction, type SubscribeOptions, subscribe, type JoinWaitlistOptions, type JoinWaitlistResponse, joinWaitlist, type ViewCountsOptions, type ViewCounts, type RecordViewResponse, getViewCounts, recordView, type SubmitFeedbackOptions, type SubmitFeedbackResponse, submitFeedback, type FetchPollOptions, fetchPoll, type VotePollOptions, type VotePollResponse, votePoll, type FetchAnnouncementsOptions, fetchAnnouncements, type DismissAnnouncementOptions, dismissAnnouncement, type FetchPostsOptions, fetchPosts, type FetchPostOptions, fetchPost, type SiteConfig, fetchSiteConfig, POWERED_BY_URL, POWERED_BY_LABEL, 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";
 export { jamwidgetsPostsLoader, seriphPostsLoader, // deprecated alias
 type JamwidgetsPostsLoaderOptions, type SeriphPostsLoaderOptions, } from "./loader.js";

package/dist/index.js

@@ -9,7 +9,7 @@ export {
 // Constants
 DEFAULT_ENDPOINT, API_PATH, VISITOR_STORAGE_KEY, 
 // Helpers
-buildUrl, getSiteKey, getVisitorId, setVisitorId, submitForm, fetchComments, postComment, fetchReactions, addReaction, removeReaction, subscribe, joinWaitlist, getViewCounts, recordView, submitFeedback, fetchPoll, votePoll, fetchAnnouncements, dismissAnnouncement, fetchPosts, fetchPost, SubscribeController, WaitlistController, FormController, ReactionsController, CommentsController, ViewCountsController, FeedbackController, PollController, AnnouncementsController, } from "@jamwidgets/core";
+buildUrl, getSiteKey, getVisitorId, setVisitorId, submitForm, fetchComments, postComment, fetchReactions, addReaction, removeReaction, subscribe, joinWaitlist, getViewCounts, recordView, submitFeedback, fetchPoll, votePoll, fetchAnnouncements, dismissAnnouncement, fetchPosts, fetchPost, fetchSiteConfig, POWERED_BY_URL, POWERED_BY_LABEL, SubscribeController, WaitlistController, FormController, ReactionsController, CommentsController, ViewCountsController, FeedbackController, PollController, AnnouncementsController, } from "@jamwidgets/core";
 // Re-export loader (Astro-specific)
 export { jamwidgetsPostsLoader, seriphPostsLoader, // deprecated alias
  } from "./loader.js";

package/dist/loader.d.ts

@@ -18,6 +18,7 @@
  */
 import { fetchPosts as coreFetchPosts, fetchPost as coreFetchPost, type JamwidgetsPost, type SeriphPost, // deprecated alias
 type FetchPostsOptions, type FetchPostOptions } from "@jamwidgets/core";
+import type { Loader } from "astro/loaders";
 export type { JamwidgetsPost, SeriphPost, FetchPostsOptions, FetchPostOptions };
 export { coreFetchPosts as fetchPosts, coreFetchPost as fetchPost };
 export interface JamwidgetsPostsLoaderOptions {
@@ -34,29 +35,11 @@ export interface JamwidgetsPostsLoaderOptions {
 }
 /** @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;
-}
 /**
  * Creates an Astro content loader that fetches posts from Jamwidgets.
  *
  * Posts are fetched at build time and cached by Astro.
  */
-export declare function jamwidgetsPostsLoader(options: JamwidgetsPostsLoaderOptions): {
-    name: string;
-    load(context: LoaderContext): Promise<void>;
-};
+export declare function jamwidgetsPostsLoader(options: JamwidgetsPostsLoaderOptions): Loader;
 /** @deprecated Use jamwidgetsPostsLoader instead */
 export declare const seriphPostsLoader: typeof jamwidgetsPostsLoader;

package/dist/loader.js

@@ -43,6 +43,8 @@ export function jamwidgetsPostsLoader(options) {
                         "X-Jamwidgets-Key": siteKey,
                         // Legacy headers for backward compatibility
                         "X-Seriph-Key": siteKey,
+                        // User-Agent to avoid bot detection (Cloudflare, etc.)
+                        "User-Agent": "JamwidgetsAstroLoader/1.0",
                     },
                 });
                 if (!response.ok) {
@@ -53,7 +55,7 @@ export function jamwidgetsPostsLoader(options) {
                 for (const post of data.posts) {
                     store.set({
                         id: post.slug,
-                        data: post,
+                        data: { ...post },
                     });
                 }
                 logger.info(`Loaded ${data.posts.length} posts from Jamwidgets`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jamwidgets/astro",
-  "version": "0.1.1",
+  "version": "0.3.1",
   "description": "Astro components and content loader for Jamwidgets (forms, comments, reactions, posts)",
   "repository": {
     "type": "git",
@@ -23,8 +23,10 @@
     },
     "./Form": "./src/Form.astro",
     "./Comments": "./src/Comments.astro",
+    "./PoweredBy": "./src/PoweredBy.astro",
     "./Reactions": "./src/Reactions.astro",
     "./Views": "./src/Views.astro",
+    "./Analytics": "./src/Analytics.astro",
     "./Poll": "./src/Poll.astro",
     "./Subscribe": "./src/Subscribe.astro",
     "./SubscribeForm": "./src/SubscribeForm.astro",
@@ -37,6 +39,10 @@
     "src",
     "dist"
   ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
   "keywords": [
     "astro",
     "jamwidgets",
@@ -50,16 +56,13 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@jamwidgets/core": "0.1.1"
+    "@jamwidgets/core": "^0.3.1"
   },
   "peerDependencies": {
-    "astro": "^5.0.0"
+    "astro": "^5.0.0 || ^6.0.0 || ^7.0.0"
   },
   "devDependencies": {
-    "typescript": "^5.7.3"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch"
+    "astro": "^7.1.3",
+    "typescript": "^5.9.3"
   }
-}
+}

package/src/Analytics.astro

@@ -0,0 +1,30 @@
+---
+interface Props {
+  /** Falls back to the `jamwidgets-site-key` meta tag. */
+  siteKey?: string;
+  /** Defaults to `https://jamwidgets.com`. */
+  endpoint?: string;
+}
+
+const { siteKey = "", endpoint = "" } = Astro.props;
+---
+
+<div
+  data-jamwidgets-analytics
+  data-site-key={siteKey}
+  data-endpoint={endpoint}
+  hidden
+>
+</div>
+
+<script>
+  import { initAnalytics } from "@jamwidgets/core";
+
+  const el = document.querySelector("[data-jamwidgets-analytics]") as
+    | HTMLElement
+    | null;
+  initAnalytics({
+    siteKey: el?.dataset.siteKey || undefined,
+    endpoint: el?.dataset.endpoint || undefined,
+  });
+</script>

package/src/Comments.astro

@@ -35,6 +35,8 @@ const {
 
 // Build the API URL
 const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
+
+import PoweredBy from "./PoweredBy.astro";
 ---
 
 <div
@@ -85,9 +87,13 @@ const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
       <div class="jamwidgets-comment-replies"></div>
     </div>
   </template>
+
+  <PoweredBy siteKey={siteKey} endpoint={endpoint} />
 </div>
 
 <script>
+  import { getAttributionHeaders, getVisitorId } from "@jamwidgets/core";
+
   interface Comment {
     id: string;
     authorName: string;
@@ -96,17 +102,6 @@ const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
     replies: Comment[];
   }
 
-  // Get or create a visitor ID for anonymous users
-  const VISITOR_KEY = "jamwidgets_visitor_id";
-  function getVisitorId(): string {
-    let id = localStorage.getItem(VISITOR_KEY);
-    if (!id) {
-      id = crypto.randomUUID();
-      localStorage.setItem(VISITOR_KEY, id);
-    }
-    return id;
-  }
-
   // Store form load timestamps for spam detection
   const formTimestamps = new WeakMap<Element, number>();
 
@@ -126,6 +121,7 @@ const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
 
     const visitorId = getVisitorId();
     const headers = {
+      ...getAttributionHeaders(pageId),
       "X-JamWidgets-Key": siteKey,
       "X-JamWidgets-Visitor": visitorId,
     };

package/src/Feedback.astro

@@ -38,6 +38,8 @@ const {
 
 // Build the API URL
 const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
+
+import PoweredBy from "./PoweredBy.astro";
 ---
 
 <div
@@ -81,6 +83,8 @@ const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
       </button>
     </div>
   </form>
+
+  <PoweredBy siteKey={siteKey} endpoint={endpoint} />
 </div>
 
 <script>

package/src/Form.astro

@@ -40,6 +40,8 @@ const {
 
 // Build the API URL
 const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
+
+import PoweredBy from "./PoweredBy.astro";
 ---
 
 <form
@@ -58,25 +60,18 @@ const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
 
   <!-- Success/Error message container (hidden by default) -->
   <div class="jamwidgets-form-message" style="display: none;" aria-live="polite"></div>
+
+  <PoweredBy siteKey={siteKey} endpoint={endpoint} />
 </form>
 
 <script>
+  import { getAttributionHeaders, getVisitorId } from "@jamwidgets/core";
+
   interface FormSubmitResponse {
     success: boolean;
     message: string;
   }
 
-  // Get or create a visitor ID for anonymous users
-  const VISITOR_KEY = "jamwidgets_visitor_id";
-  function getVisitorId(): string {
-    let id = localStorage.getItem(VISITOR_KEY);
-    if (!id) {
-      id = crypto.randomUUID();
-      localStorage.setItem(VISITOR_KEY, id);
-    }
-    return id;
-  }
-
   // Store form load timestamps for spam detection
   const formTimestamps = new WeakMap<Element, number>();
 
@@ -130,6 +125,7 @@ const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
         const response = await fetch(`${endpoint}/forms/${formSlug}/submit`, {
           method: "POST",
           headers: {
+            ...getAttributionHeaders(),
             "Content-Type": "application/json",
             "X-JamWidgets-Key": siteKey,
             "X-JamWidgets-Visitor": getVisitorId(),

package/src/Poll.astro

@@ -38,6 +38,8 @@ const {
 
 // Build the API URL
 const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
+
+import PoweredBy from "./PoweredBy.astro";
 ---
 
 <div
@@ -60,6 +62,8 @@ const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
     <button type="button" class="jamwidgets-poll-submit" style="display: none;">Vote</button>
   </div>
   <div class="jamwidgets-poll-error" style="display: none;"></div>
+
+  <PoweredBy siteKey={siteKey} endpoint={endpoint} />
 </div>
 
 <script>

package/src/PoweredBy.astro

@@ -0,0 +1,83 @@
+---
+/**
+ * JamWidgets "Powered by" footer.
+ *
+ * Rendered at the bottom of a drop-in widget. It hydrates hidden and only
+ * reveals itself when the site is on the Free tier (no custom branding) — the
+ * gate is the `hasCustomBranding` flag from `GET /api/v1/site`. Paid tiers
+ * (Pro/Team) keep it hidden, and if the config fetch fails we stay hidden so a
+ * paying site is never wrongly branded.
+ *
+ * Included by the block widgets (Comments, Form, Subscribe, Poll, Feedback,
+ * Waitlist); not the ambient ones (Reactions, Views, Announcements).
+ */
+interface Props {
+  /** Your site key (required) */
+  siteKey: string;
+  /** Base URL of your JamWidgets instance (default: 'https://jamwidgets.com') */
+  endpoint?: string;
+}
+
+const DEFAULT_ENDPOINT = "https://jamwidgets.com";
+const API_PATH = "/api/v1";
+
+const { siteKey, endpoint = DEFAULT_ENDPOINT } = Astro.props;
+const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
+---
+
+<div
+  class="jamwidgets-powered-by"
+  data-jamwidgets-branding
+  data-endpoint={baseUrl}
+  data-site-key={siteKey}
+  hidden
+>
+  <a href="https://jamwidgets.com/?utm_source=powered_by" target="_blank" rel="noopener noreferrer">
+    Powered by JamWidgets
+  </a>
+</div>
+
+<script>
+  // Reveal the footer only for sites without custom branding (Free tier).
+  // Site config is fetched once per (endpoint, siteKey); on any failure we
+  // leave the footer hidden (fail closed — never brand a paying site).
+  const brandingCache = new Map<string, Promise<boolean>>();
+
+  function hasCustomBranding(baseUrl: string, siteKey: string): Promise<boolean> {
+    const key = `${baseUrl}::${siteKey}`;
+    let pending = brandingCache.get(key);
+    if (!pending) {
+      pending = fetch(`${baseUrl}/site`, { headers: { "X-JamWidgets-Key": siteKey } })
+        .then((res) => (res.ok ? res.json() : null))
+        .then((data) => data?.site_config?.hasCustomBranding === true)
+        .catch(() => true);
+      brandingCache.set(key, pending);
+    }
+    return pending;
+  }
+
+  document.querySelectorAll<HTMLElement>("[data-jamwidgets-branding]").forEach((el) => {
+    const baseUrl = el.dataset.endpoint;
+    const siteKey = el.dataset.siteKey;
+    if (!baseUrl || !siteKey) return;
+    hasCustomBranding(baseUrl, siteKey).then((custom) => {
+      if (!custom) el.removeAttribute("hidden");
+    });
+  });
+</script>
+
+<style>
+  .jamwidgets-powered-by {
+    margin-top: 0.75rem;
+    text-align: center;
+    font-size: 0.75rem;
+    line-height: 1;
+  }
+  .jamwidgets-powered-by a {
+    color: var(--jamwidgets-muted-color, #9ca3af);
+    text-decoration: none;
+  }
+  .jamwidgets-powered-by a:hover {
+    text-decoration: underline;
+  }
+</style>

package/src/Reactions.astro

@@ -87,16 +87,7 @@ const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
 </div>
 
 <script>
-  // Get or create a visitor ID for anonymous users
-  const VISITOR_KEY = "jamwidgets_visitor_id";
-  function getVisitorId(): string {
-    let id = localStorage.getItem(VISITOR_KEY);
-    if (!id) {
-      id = crypto.randomUUID();
-      localStorage.setItem(VISITOR_KEY, id);
-    }
-    return id;
-  }
+  import { getAttributionHeaders, getVisitorId } from "@jamwidgets/core";
 
   document.querySelectorAll("[data-jamwidgets-reactions]").forEach((container) => {
     const endpoint = (container as HTMLElement).dataset.endpoint;
@@ -107,6 +98,7 @@ const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
 
     const visitorId = getVisitorId();
     const headers = {
+      ...getAttributionHeaders(pageId),
       "X-JamWidgets-Key": siteKey,
       "X-JamWidgets-Visitor": visitorId,
     };

package/src/Subscribe.astro

@@ -49,6 +49,8 @@ const {
 
 // Build the API URL
 const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
+
+import PoweredBy from "./PoweredBy.astro";
 ---
 
 <form
@@ -79,6 +81,8 @@ const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
 
   <!-- Success/Error message container (hidden by default) -->
   <div class="jamwidgets-subscribe-message" style="display: none;" aria-live="polite"></div>
+
+  <PoweredBy siteKey={siteKey} endpoint={endpoint} />
 </form>
 
 <script>

package/src/SubscribeForm.astro

@@ -71,22 +71,13 @@ const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
 </form>
 
 <script>
+  import { getAttributionHeaders, getVisitorId } from "@jamwidgets/core";
+
   interface SubscribeResponse {
     success: boolean;
     message: string;
   }
 
-  // Get or create a visitor ID for anonymous users
-  const VISITOR_KEY = "jamwidgets_visitor_id";
-  function getVisitorId(): string {
-    let id = localStorage.getItem(VISITOR_KEY);
-    if (!id) {
-      id = crypto.randomUUID();
-      localStorage.setItem(VISITOR_KEY, id);
-    }
-    return id;
-  }
-
   document.querySelectorAll("[data-jamwidgets-subscribe-form]").forEach((form) => {
     form.addEventListener("submit", async (e) => {
       e.preventDefault();
@@ -114,6 +105,7 @@ const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
         const response = await fetch(`${endpoint}/subscribe`, {
           method: "POST",
           headers: {
+            ...getAttributionHeaders(),
             "Content-Type": "application/json",
             "X-JamWidgets-Key": siteKey,
             "X-JamWidgets-Visitor": getVisitorId(),

package/src/Waitlist.astro

@@ -40,6 +40,8 @@ const {
 
 // Build the API URL
 const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
+
+import PoweredBy from "./PoweredBy.astro";
 ---
 
 <div
@@ -62,6 +64,8 @@ const baseUrl = endpoint.replace(/\/+$/, "") + API_PATH;
     </button>
   </form>
   <div class="jamwidgets-waitlist-message" style="display: none;"></div>
+
+  <PoweredBy siteKey={siteKey} endpoint={endpoint} />
 </div>
 
 <script>

package/src/index.ts

@@ -95,6 +95,12 @@ export {
   type FetchPostOptions,
   fetchPost,
 
+  // Site config + branding
+  type SiteConfig,
+  fetchSiteConfig,
+  POWERED_BY_URL,
+  POWERED_BY_LABEL,
+
   // Controllers
   type ControllerStatus,
   type ControllerListener,

package/src/loader.ts

@@ -28,6 +28,7 @@ import {
   type FetchPostsOptions,
   type FetchPostOptions,
 } from "@jamwidgets/core";
+import type { Loader, LoaderContext } from "astro/loaders";
 
 // Re-export types and functions from core
 export type { JamwidgetsPost, SeriphPost, FetchPostsOptions, FetchPostOptions };
@@ -49,19 +50,6 @@ export interface JamwidgetsPostsLoaderOptions {
 /** @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;
@@ -72,7 +60,7 @@ interface ApiResponse {
  *
  * Posts are fetched at build time and cached by Astro.
  */
-export function jamwidgetsPostsLoader(options: JamwidgetsPostsLoaderOptions) {
+export function jamwidgetsPostsLoader(options: JamwidgetsPostsLoaderOptions): Loader {
   const {
     endpoint = DEFAULT_ENDPOINT,
     tag,
@@ -103,6 +91,8 @@ export function jamwidgetsPostsLoader(options: JamwidgetsPostsLoaderOptions) {
             "X-Jamwidgets-Key": siteKey,
             // Legacy headers for backward compatibility
             "X-Seriph-Key": siteKey,
+            // User-Agent to avoid bot detection (Cloudflare, etc.)
+            "User-Agent": "JamwidgetsAstroLoader/1.0",
           },
         });
 
@@ -119,7 +109,7 @@ export function jamwidgetsPostsLoader(options: JamwidgetsPostsLoaderOptions) {
         for (const post of data.posts) {
           store.set({
             id: post.slug,
-            data: post,
+            data: { ...post },
           });
         }