@volchoklv/newsletter-kit 1.0.0

package/dist/components/index.js

@@ -0,0 +1,505 @@
+"use client";
+
+// src/components/newsletter-form.tsx
+import { useState, useCallback } from "react";
+
+// src/utils/cn.ts
+function cn(...inputs) {
+  return inputs.filter(Boolean).join(" ");
+}
+
+// src/components/newsletter-form.tsx
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+function NewsletterForm({
+  endpoint = "/api/newsletter/subscribe",
+  source,
+  tags,
+  honeypotField = "website",
+  className,
+  formClassName,
+  inputClassName,
+  buttonClassName,
+  messageClassName,
+  placeholder = "Enter your email",
+  buttonText = "Subscribe",
+  loadingText = "Subscribing...",
+  successMessage,
+  errorMessage,
+  showMessage = true,
+  onSuccess,
+  onError,
+  onSubmit,
+  disabled = false,
+  metadata
+}) {
+  const [state, setState] = useState({
+    status: "idle",
+    message: "",
+    email: ""
+  });
+  const handleSubmit = useCallback(
+    async (e) => {
+      e.preventDefault();
+      const formData = new FormData(e.currentTarget);
+      const email = formData.get("email");
+      const honeypot = formData.get(honeypotField);
+      if (honeypot) {
+        setState({
+          status: "success",
+          message: successMessage || "Thanks for subscribing!",
+          email: ""
+        });
+        return;
+      }
+      if (!email || !email.includes("@")) {
+        setState({
+          status: "error",
+          message: "Please enter a valid email address.",
+          email
+        });
+        onError?.("Please enter a valid email address.");
+        return;
+      }
+      setState({ status: "loading", message: "", email });
+      onSubmit?.(email);
+      try {
+        const response = await fetch(endpoint, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({
+            email,
+            source,
+            tags,
+            metadata
+          })
+        });
+        const data = await response.json();
+        if (response.ok && data.success) {
+          const message = successMessage || data.message || "Thanks for subscribing!";
+          setState({
+            status: "success",
+            message,
+            email: ""
+          });
+          onSuccess?.(email, message);
+        } else {
+          const message = errorMessage || data.message || "Something went wrong. Please try again.";
+          setState({
+            status: "error",
+            message,
+            email
+          });
+          onError?.(message);
+        }
+      } catch (error) {
+        const message = errorMessage || "Network error. Please try again.";
+        setState({
+          status: "error",
+          message,
+          email
+        });
+        onError?.(message);
+      }
+    },
+    [endpoint, source, tags, metadata, honeypotField, successMessage, errorMessage, onSuccess, onError, onSubmit]
+  );
+  const isLoading = state.status === "loading";
+  const isDisabled = disabled || isLoading;
+  return /* @__PURE__ */ jsxs("div", { className: cn("w-full", className), children: [
+    /* @__PURE__ */ jsxs(
+      "form",
+      {
+        onSubmit: handleSubmit,
+        className: cn("flex flex-col sm:flex-row gap-2", formClassName),
+        children: [
+          /* @__PURE__ */ jsx(
+            "input",
+            {
+              type: "text",
+              name: honeypotField,
+              autoComplete: "off",
+              tabIndex: -1,
+              "aria-hidden": "true",
+              className: "absolute -left-[9999px] opacity-0 pointer-events-none"
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            "input",
+            {
+              type: "email",
+              name: "email",
+              placeholder,
+              required: true,
+              disabled: isDisabled,
+              defaultValue: state.email,
+              "aria-label": "Email address",
+              "aria-describedby": state.message ? "newsletter-message" : void 0,
+              className: cn(
+                "flex h-10 w-full rounded-md border border-input bg-background px-3 py-2 text-sm",
+                "ring-offset-background file:border-0 file:bg-transparent file:text-sm file:font-medium",
+                "placeholder:text-muted-foreground",
+                "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2",
+                "disabled:cursor-not-allowed disabled:opacity-50",
+                inputClassName
+              )
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "submit",
+              disabled: isDisabled,
+              className: cn(
+                "inline-flex items-center justify-center whitespace-nowrap rounded-md text-sm font-medium",
+                "ring-offset-background transition-colors",
+                "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2",
+                "disabled:pointer-events-none disabled:opacity-50",
+                "bg-primary text-primary-foreground hover:bg-primary/90",
+                "h-10 px-4 py-2",
+                "min-w-[120px]",
+                buttonClassName
+              ),
+              children: isLoading ? /* @__PURE__ */ jsxs(Fragment, { children: [
+                /* @__PURE__ */ jsxs(
+                  "svg",
+                  {
+                    className: "mr-2 h-4 w-4 animate-spin",
+                    xmlns: "http://www.w3.org/2000/svg",
+                    fill: "none",
+                    viewBox: "0 0 24 24",
+                    children: [
+                      /* @__PURE__ */ jsx(
+                        "circle",
+                        {
+                          className: "opacity-25",
+                          cx: "12",
+                          cy: "12",
+                          r: "10",
+                          stroke: "currentColor",
+                          strokeWidth: "4"
+                        }
+                      ),
+                      /* @__PURE__ */ jsx(
+                        "path",
+                        {
+                          className: "opacity-75",
+                          fill: "currentColor",
+                          d: "M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"
+                        }
+                      )
+                    ]
+                  }
+                ),
+                loadingText
+              ] }) : buttonText
+            }
+          )
+        ]
+      }
+    ),
+    showMessage && state.message && /* @__PURE__ */ jsx(
+      "p",
+      {
+        id: "newsletter-message",
+        role: state.status === "error" ? "alert" : "status",
+        className: cn(
+          "mt-2 text-sm",
+          state.status === "success" && "text-green-600 dark:text-green-400",
+          state.status === "error" && "text-red-600 dark:text-red-400",
+          messageClassName
+        ),
+        children: state.message
+      }
+    )
+  ] });
+}
+
+// src/components/newsletter-blocks.tsx
+import { Fragment as Fragment2, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function NewsletterBlock({
+  title = "Subscribe to our newsletter",
+  description = "Get the latest updates delivered directly to your inbox.",
+  containerClassName,
+  titleClassName,
+  descriptionClassName,
+  ...formProps
+}) {
+  return /* @__PURE__ */ jsx2(
+    "section",
+    {
+      className: cn(
+        "w-full py-12 md:py-16 lg:py-20",
+        "bg-muted/50",
+        containerClassName
+      ),
+      children: /* @__PURE__ */ jsx2("div", { className: "container mx-auto px-4 md:px-6", children: /* @__PURE__ */ jsxs2("div", { className: "flex flex-col items-center justify-center space-y-4 text-center", children: [
+        /* @__PURE__ */ jsxs2("div", { className: "space-y-2", children: [
+          /* @__PURE__ */ jsx2(
+            "h2",
+            {
+              className: cn(
+                "text-2xl font-bold tracking-tight sm:text-3xl md:text-4xl",
+                titleClassName
+              ),
+              children: title
+            }
+          ),
+          /* @__PURE__ */ jsx2(
+            "p",
+            {
+              className: cn(
+                "max-w-[600px] text-muted-foreground md:text-lg",
+                descriptionClassName
+              ),
+              children: description
+            }
+          )
+        ] }),
+        /* @__PURE__ */ jsx2("div", { className: "w-full max-w-md", children: /* @__PURE__ */ jsx2(NewsletterForm, { ...formProps }) })
+      ] }) })
+    }
+  );
+}
+function NewsletterCard({
+  title = "Newsletter",
+  description = "Subscribe to get updates.",
+  cardClassName,
+  titleClassName,
+  descriptionClassName,
+  ...formProps
+}) {
+  return /* @__PURE__ */ jsx2(
+    "div",
+    {
+      className: cn(
+        "rounded-lg border bg-card text-card-foreground shadow-sm",
+        "p-6",
+        cardClassName
+      ),
+      children: /* @__PURE__ */ jsxs2("div", { className: "space-y-4", children: [
+        /* @__PURE__ */ jsxs2("div", { className: "space-y-1.5", children: [
+          /* @__PURE__ */ jsx2(
+            "h3",
+            {
+              className: cn(
+                "text-lg font-semibold leading-none tracking-tight",
+                titleClassName
+              ),
+              children: title
+            }
+          ),
+          /* @__PURE__ */ jsx2(
+            "p",
+            {
+              className: cn(
+                "text-sm text-muted-foreground",
+                descriptionClassName
+              ),
+              children: description
+            }
+          )
+        ] }),
+        /* @__PURE__ */ jsx2(NewsletterForm, { ...formProps })
+      ] })
+    }
+  );
+}
+function NewsletterInline({
+  label,
+  labelClassName,
+  ...formProps
+}) {
+  return /* @__PURE__ */ jsxs2("div", { className: "flex flex-col gap-2", children: [
+    label && /* @__PURE__ */ jsx2(
+      "label",
+      {
+        className: cn(
+          "text-sm font-medium leading-none",
+          labelClassName
+        ),
+        children: label
+      }
+    ),
+    /* @__PURE__ */ jsx2(NewsletterForm, { ...formProps })
+  ] });
+}
+function NewsletterModalContent({
+  title = "Subscribe to our newsletter",
+  description = "We'll send you the best content, no spam.",
+  titleClassName,
+  descriptionClassName,
+  ...formProps
+}) {
+  return /* @__PURE__ */ jsxs2("div", { className: "space-y-4", children: [
+    /* @__PURE__ */ jsxs2("div", { className: "space-y-2 text-center", children: [
+      /* @__PURE__ */ jsx2(
+        "h2",
+        {
+          className: cn(
+            "text-lg font-semibold leading-none tracking-tight",
+            titleClassName
+          ),
+          children: title
+        }
+      ),
+      /* @__PURE__ */ jsx2(
+        "p",
+        {
+          className: cn(
+            "text-sm text-muted-foreground",
+            descriptionClassName
+          ),
+          children: description
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsx2(
+      NewsletterForm,
+      {
+        ...formProps,
+        formClassName: "flex-col",
+        buttonClassName: "w-full"
+      }
+    )
+  ] });
+}
+function NewsletterFooter({
+  title = "Newsletter",
+  description,
+  containerClassName,
+  titleClassName,
+  descriptionClassName,
+  privacyText,
+  privacyLink,
+  ...formProps
+}) {
+  return /* @__PURE__ */ jsxs2("div", { className: cn("space-y-4", containerClassName), children: [
+    title && /* @__PURE__ */ jsx2(
+      "h3",
+      {
+        className: cn(
+          "text-sm font-semibold uppercase tracking-wider",
+          titleClassName
+        ),
+        children: title
+      }
+    ),
+    description && /* @__PURE__ */ jsx2(
+      "p",
+      {
+        className: cn(
+          "text-sm text-muted-foreground",
+          descriptionClassName
+        ),
+        children: description
+      }
+    ),
+    /* @__PURE__ */ jsx2(NewsletterForm, { ...formProps }),
+    privacyText && /* @__PURE__ */ jsx2("p", { className: "text-xs text-muted-foreground", children: privacyLink ? /* @__PURE__ */ jsxs2(Fragment2, { children: [
+      privacyText.replace(/\.$/, ""),
+      ".",
+      " ",
+      /* @__PURE__ */ jsx2("a", { href: privacyLink, className: "underline hover:text-foreground", children: "Privacy Policy" })
+    ] }) : privacyText })
+  ] });
+}
+
+// src/hooks/use-newsletter.ts
+import { useState as useState2, useCallback as useCallback2 } from "react";
+function useNewsletter(options = {}) {
+  const {
+    endpoint = "/api/newsletter/subscribe",
+    source,
+    tags,
+    metadata,
+    onSuccess,
+    onError
+  } = options;
+  const [state, setState] = useState2({
+    status: "idle",
+    message: "",
+    email: null
+  });
+  const subscribe = useCallback2(
+    async (email) => {
+      if (!email || !email.includes("@")) {
+        const errorMsg = "Please enter a valid email address.";
+        setState({
+          status: "error",
+          message: errorMsg,
+          email
+        });
+        onError?.(errorMsg);
+        return false;
+      }
+      setState({ status: "loading", message: "", email });
+      try {
+        const response = await fetch(endpoint, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({
+            email,
+            source,
+            tags,
+            metadata
+          })
+        });
+        const data = await response.json();
+        if (response.ok && data.success) {
+          const message = data.message || "Thanks for subscribing!";
+          setState({
+            status: "success",
+            message,
+            email
+          });
+          onSuccess?.(email, message);
+          return true;
+        } else {
+          const message = data.message || "Something went wrong. Please try again.";
+          setState({
+            status: "error",
+            message,
+            email
+          });
+          onError?.(message);
+          return false;
+        }
+      } catch (error) {
+        const message = "Network error. Please try again.";
+        setState({
+          status: "error",
+          message,
+          email
+        });
+        onError?.(message);
+        return false;
+      }
+    },
+    [endpoint, source, tags, metadata, onSuccess, onError]
+  );
+  const reset = useCallback2(() => {
+    setState({
+      status: "idle",
+      message: "",
+      email: null
+    });
+  }, []);
+  return {
+    ...state,
+    subscribe,
+    reset,
+    isLoading: state.status === "loading",
+    isSuccess: state.status === "success",
+    isError: state.status === "error"
+  };
+}
+export {
+  NewsletterBlock,
+  NewsletterCard,
+  NewsletterFooter,
+  NewsletterForm,
+  NewsletterInline,
+  NewsletterModalContent,
+  useNewsletter
+};
+//# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/newsletter-form.tsx","../../src/utils/cn.ts","../../src/components/newsletter-blocks.tsx","../../src/hooks/use-newsletter.ts"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { useState, useCallback, FormEvent } from 'react';\nimport type { NewsletterFormProps, NewsletterFormState } from '../types';\nimport { cn } from '../utils/cn';\n\n/**\n * Newsletter subscription form component\n * \n * Designed to work with shadcn/ui but includes default Tailwind styles.\n * \n * @example\n * ```tsx\n * // Basic usage\n * <NewsletterForm endpoint=\"/api/newsletter/subscribe\" />\n * \n * // With all options\n * <NewsletterForm\n *   endpoint=\"/api/newsletter/subscribe\"\n *   source=\"footer\"\n *   tags={['marketing']}\n *   placeholder=\"Enter your email\"\n *   buttonText=\"Subscribe\"\n *   successMessage=\"Check your inbox!\"\n *   onSuccess={(email) => console.log('Subscribed:', email)}\n *   onError={(error) => console.error('Error:', error)}\n *   className=\"max-w-md\"\n * />\n * ```\n */\nexport function NewsletterForm({\n  endpoint = '/api/newsletter/subscribe',\n  source,\n  tags,\n  honeypotField = 'website',\n  className,\n  formClassName,\n  inputClassName,\n  buttonClassName,\n  messageClassName,\n  placeholder = 'Enter your email',\n  buttonText = 'Subscribe',\n  loadingText = 'Subscribing...',\n  successMessage,\n  errorMessage,\n  showMessage = true,\n  onSuccess,\n  onError,\n  onSubmit,\n  disabled = false,\n  metadata,\n}: NewsletterFormProps) {\n  const [state, setState] = useState<NewsletterFormState>({\n    status: 'idle',\n    message: '',\n    email: '',\n  });\n\n  const handleSubmit = useCallback(\n    async (e: FormEvent<HTMLFormElement>) => {\n      e.preventDefault();\n\n      const formData = new FormData(e.currentTarget);\n      const email = formData.get('email') as string;\n      const honeypot = formData.get(honeypotField) as string;\n\n      // If honeypot is filled, silently \"succeed\" (bot detection)\n      if (honeypot) {\n        setState({\n          status: 'success',\n          message: successMessage || 'Thanks for subscribing!',\n          email: '',\n        });\n        return;\n      }\n\n      if (!email || !email.includes('@')) {\n        setState({\n          status: 'error',\n          message: 'Please enter a valid email address.',\n          email,\n        });\n        onError?.('Please enter a valid email address.');\n        return;\n      }\n\n      setState({ status: 'loading', message: '', email });\n      onSubmit?.(email);\n\n      try {\n        const response = await fetch(endpoint, {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify({\n            email,\n            source,\n            tags,\n            metadata,\n          }),\n        });\n\n        const data = await response.json();\n\n        if (response.ok && data.success) {\n          const message = successMessage || data.message || 'Thanks for subscribing!';\n          setState({\n            status: 'success',\n            message,\n            email: '',\n          });\n          onSuccess?.(email, message);\n        } else {\n          const message = errorMessage || data.message || 'Something went wrong. Please try again.';\n          setState({\n            status: 'error',\n            message,\n            email,\n          });\n          onError?.(message);\n        }\n      } catch (error) {\n        const message = errorMessage || 'Network error. Please try again.';\n        setState({\n          status: 'error',\n          message,\n          email,\n        });\n        onError?.(message);\n      }\n    },\n    [endpoint, source, tags, metadata, honeypotField, successMessage, errorMessage, onSuccess, onError, onSubmit]\n  );\n\n  const isLoading = state.status === 'loading';\n  const isDisabled = disabled || isLoading;\n\n  return (\n    <div className={cn('w-full', className)}>\n      <form\n        onSubmit={handleSubmit}\n        className={cn('flex flex-col sm:flex-row gap-2', formClassName)}\n      >\n        {/* Honeypot field - hidden from users, visible to bots */}\n        <input\n          type=\"text\"\n          name={honeypotField}\n          autoComplete=\"off\"\n          tabIndex={-1}\n          aria-hidden=\"true\"\n          className=\"absolute -left-[9999px] opacity-0 pointer-events-none\"\n        />\n\n        <input\n          type=\"email\"\n          name=\"email\"\n          placeholder={placeholder}\n          required\n          disabled={isDisabled}\n          defaultValue={state.email}\n          aria-label=\"Email address\"\n          aria-describedby={state.message ? 'newsletter-message' : undefined}\n          className={cn(\n            'flex h-10 w-full rounded-md border border-input bg-background px-3 py-2 text-sm',\n            'ring-offset-background file:border-0 file:bg-transparent file:text-sm file:font-medium',\n            'placeholder:text-muted-foreground',\n            'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2',\n            'disabled:cursor-not-allowed disabled:opacity-50',\n            inputClassName\n          )}\n        />\n\n        <button\n          type=\"submit\"\n          disabled={isDisabled}\n          className={cn(\n            'inline-flex items-center justify-center whitespace-nowrap rounded-md text-sm font-medium',\n            'ring-offset-background transition-colors',\n            'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2',\n            'disabled:pointer-events-none disabled:opacity-50',\n            'bg-primary text-primary-foreground hover:bg-primary/90',\n            'h-10 px-4 py-2',\n            'min-w-[120px]',\n            buttonClassName\n          )}\n        >\n          {isLoading ? (\n            <>\n              <svg\n                className=\"mr-2 h-4 w-4 animate-spin\"\n                xmlns=\"http://www.w3.org/2000/svg\"\n                fill=\"none\"\n                viewBox=\"0 0 24 24\"\n              >\n                <circle\n                  className=\"opacity-25\"\n                  cx=\"12\"\n                  cy=\"12\"\n                  r=\"10\"\n                  stroke=\"currentColor\"\n                  strokeWidth=\"4\"\n                />\n                <path\n                  className=\"opacity-75\"\n                  fill=\"currentColor\"\n                  d=\"M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z\"\n                />\n              </svg>\n              {loadingText}\n            </>\n          ) : (\n            buttonText\n          )}\n        </button>\n      </form>\n\n      {showMessage && state.message && (\n        <p\n          id=\"newsletter-message\"\n          role={state.status === 'error' ? 'alert' : 'status'}\n          className={cn(\n            'mt-2 text-sm',\n            state.status === 'success' && 'text-green-600 dark:text-green-400',\n            state.status === 'error' && 'text-red-600 dark:text-red-400',\n            messageClassName\n          )}\n        >\n          {state.message}\n        </p>\n      )}\n    </div>\n  );\n}\n","/**\n * Utility for merging class names\n * Compatible with shadcn/ui's cn function\n */\nexport function cn(...inputs: (string | undefined | null | false)[]): string {\n  return inputs.filter(Boolean).join(' ');\n}\n","'use client';\n\nimport * as React from 'react';\nimport { NewsletterForm } from './newsletter-form';\nimport type { NewsletterFormProps } from '../types';\nimport { cn } from '../utils/cn';\n\n// ============================================================================\n// Newsletter Block - Full width section\n// ============================================================================\n\ninterface NewsletterBlockProps extends NewsletterFormProps {\n  title?: string;\n  description?: string;\n  containerClassName?: string;\n  titleClassName?: string;\n  descriptionClassName?: string;\n}\n\n/**\n * Full-width newsletter subscription block\n * \n * @example\n * ```tsx\n * <NewsletterBlock\n *   endpoint=\"/api/newsletter/subscribe\"\n *   title=\"Stay updated\"\n *   description=\"Get the latest news delivered to your inbox.\"\n *   source=\"footer\"\n * />\n * ```\n */\nexport function NewsletterBlock({\n  title = 'Subscribe to our newsletter',\n  description = 'Get the latest updates delivered directly to your inbox.',\n  containerClassName,\n  titleClassName,\n  descriptionClassName,\n  ...formProps\n}: NewsletterBlockProps) {\n  return (\n    <section\n      className={cn(\n        'w-full py-12 md:py-16 lg:py-20',\n        'bg-muted/50',\n        containerClassName\n      )}\n    >\n      <div className=\"container mx-auto px-4 md:px-6\">\n        <div className=\"flex flex-col items-center justify-center space-y-4 text-center\">\n          <div className=\"space-y-2\">\n            <h2\n              className={cn(\n                'text-2xl font-bold tracking-tight sm:text-3xl md:text-4xl',\n                titleClassName\n              )}\n            >\n              {title}\n            </h2>\n            <p\n              className={cn(\n                'max-w-[600px] text-muted-foreground md:text-lg',\n                descriptionClassName\n              )}\n            >\n              {description}\n            </p>\n          </div>\n          <div className=\"w-full max-w-md\">\n            <NewsletterForm {...formProps} />\n          </div>\n        </div>\n      </div>\n    </section>\n  );\n}\n\n// ============================================================================\n// Newsletter Card - Contained card variant\n// ============================================================================\n\ninterface NewsletterCardProps extends NewsletterFormProps {\n  title?: string;\n  description?: string;\n  cardClassName?: string;\n  titleClassName?: string;\n  descriptionClassName?: string;\n}\n\n/**\n * Card-style newsletter subscription component\n * \n * @example\n * ```tsx\n * <NewsletterCard\n *   endpoint=\"/api/newsletter/subscribe\"\n *   title=\"Join the community\"\n *   description=\"Be the first to know about new features.\"\n *   source=\"sidebar\"\n * />\n * ```\n */\nexport function NewsletterCard({\n  title = 'Newsletter',\n  description = 'Subscribe to get updates.',\n  cardClassName,\n  titleClassName,\n  descriptionClassName,\n  ...formProps\n}: NewsletterCardProps) {\n  return (\n    <div\n      className={cn(\n        'rounded-lg border bg-card text-card-foreground shadow-sm',\n        'p-6',\n        cardClassName\n      )}\n    >\n      <div className=\"space-y-4\">\n        <div className=\"space-y-1.5\">\n          <h3\n            className={cn(\n              'text-lg font-semibold leading-none tracking-tight',\n              titleClassName\n            )}\n          >\n            {title}\n          </h3>\n          <p\n            className={cn(\n              'text-sm text-muted-foreground',\n              descriptionClassName\n            )}\n          >\n            {description}\n          </p>\n        </div>\n        <NewsletterForm {...formProps} />\n      </div>\n    </div>\n  );\n}\n\n// ============================================================================\n// Newsletter Inline - Minimal inline variant\n// ============================================================================\n\ninterface NewsletterInlineProps extends NewsletterFormProps {\n  label?: string;\n  labelClassName?: string;\n}\n\n/**\n * Inline newsletter subscription component\n * \n * @example\n * ```tsx\n * // In a footer\n * <NewsletterInline\n *   endpoint=\"/api/newsletter/subscribe\"\n *   label=\"Subscribe:\"\n *   source=\"footer\"\n * />\n * ```\n */\nexport function NewsletterInline({\n  label,\n  labelClassName,\n  ...formProps\n}: NewsletterInlineProps) {\n  return (\n    <div className=\"flex flex-col gap-2\">\n      {label && (\n        <label\n          className={cn(\n            'text-sm font-medium leading-none',\n            labelClassName\n          )}\n        >\n          {label}\n        </label>\n      )}\n      <NewsletterForm {...formProps} />\n    </div>\n  );\n}\n\n// ============================================================================\n// Newsletter Modal - Dialog/modal variant (controlled externally)\n// ============================================================================\n\ninterface NewsletterModalContentProps extends NewsletterFormProps {\n  title?: string;\n  description?: string;\n  titleClassName?: string;\n  descriptionClassName?: string;\n}\n\n/**\n * Newsletter content for use inside a modal/dialog\n * \n * Use with shadcn/ui Dialog component:\n * \n * @example\n * ```tsx\n * import { Dialog, DialogContent, DialogTrigger } from '@/components/ui/dialog';\n * import { NewsletterModalContent } from '@volchok/newsletter-kit/components';\n * \n * <Dialog>\n *   <DialogTrigger asChild>\n *     <Button>Subscribe</Button>\n *   </DialogTrigger>\n *   <DialogContent>\n *     <NewsletterModalContent\n *       endpoint=\"/api/newsletter/subscribe\"\n *       title=\"Join our newsletter\"\n *       description=\"Get weekly updates on the latest news.\"\n *       source=\"popup\"\n *       onSuccess={() => {\n *         // Close modal after success\n *         setTimeout(() => setOpen(false), 2000);\n *       }}\n *     />\n *   </DialogContent>\n * </Dialog>\n * ```\n */\nexport function NewsletterModalContent({\n  title = 'Subscribe to our newsletter',\n  description = \"We'll send you the best content, no spam.\",\n  titleClassName,\n  descriptionClassName,\n  ...formProps\n}: NewsletterModalContentProps) {\n  return (\n    <div className=\"space-y-4\">\n      <div className=\"space-y-2 text-center\">\n        <h2\n          className={cn(\n            'text-lg font-semibold leading-none tracking-tight',\n            titleClassName\n          )}\n        >\n          {title}\n        </h2>\n        <p\n          className={cn(\n            'text-sm text-muted-foreground',\n            descriptionClassName\n          )}\n        >\n          {description}\n        </p>\n      </div>\n      <NewsletterForm\n        {...formProps}\n        formClassName=\"flex-col\"\n        buttonClassName=\"w-full\"\n      />\n    </div>\n  );\n}\n\n// ============================================================================\n// Newsletter Footer - Optimized for site footers\n// ============================================================================\n\ninterface NewsletterFooterProps extends NewsletterFormProps {\n  title?: string;\n  description?: string;\n  containerClassName?: string;\n  titleClassName?: string;\n  descriptionClassName?: string;\n  privacyText?: string;\n  privacyLink?: string;\n}\n\n/**\n * Footer-optimized newsletter subscription component\n * \n * @example\n * ```tsx\n * <footer>\n *   <NewsletterFooter\n *     endpoint=\"/api/newsletter/subscribe\"\n *     title=\"Newsletter\"\n *     description=\"Stay up to date with our latest news.\"\n *     source=\"footer\"\n *     privacyText=\"We respect your privacy.\"\n *     privacyLink=\"/privacy\"\n *   />\n * </footer>\n * ```\n */\nexport function NewsletterFooter({\n  title = 'Newsletter',\n  description,\n  containerClassName,\n  titleClassName,\n  descriptionClassName,\n  privacyText,\n  privacyLink,\n  ...formProps\n}: NewsletterFooterProps) {\n  return (\n    <div className={cn('space-y-4', containerClassName)}>\n      {title && (\n        <h3\n          className={cn(\n            'text-sm font-semibold uppercase tracking-wider',\n            titleClassName\n          )}\n        >\n          {title}\n        </h3>\n      )}\n      {description && (\n        <p\n          className={cn(\n            'text-sm text-muted-foreground',\n            descriptionClassName\n          )}\n        >\n          {description}\n        </p>\n      )}\n      <NewsletterForm {...formProps} />\n      {privacyText && (\n        <p className=\"text-xs text-muted-foreground\">\n          {privacyLink ? (\n            <>\n              {privacyText.replace(/\\.$/, '')}.{' '}\n              <a href={privacyLink} className=\"underline hover:text-foreground\">\n                Privacy Policy\n              </a>\n            </>\n          ) : (\n            privacyText\n          )}\n        </p>\n      )}\n    </div>\n  );\n}\n","'use client';\n\nimport { useState, useCallback } from 'react';\n\ninterface UseNewsletterOptions {\n  endpoint?: string;\n  source?: string;\n  tags?: string[];\n  metadata?: Record<string, unknown>;\n  onSuccess?: (email: string, message: string) => void;\n  onError?: (error: string) => void;\n}\n\ninterface UseNewsletterState {\n  status: 'idle' | 'loading' | 'success' | 'error';\n  message: string;\n  email: string | null;\n}\n\ninterface UseNewsletterReturn extends UseNewsletterState {\n  subscribe: (email: string) => Promise<boolean>;\n  reset: () => void;\n  isLoading: boolean;\n  isSuccess: boolean;\n  isError: boolean;\n}\n\n/**\n * React hook for programmatic newsletter subscription\n * \n * @example\n * ```tsx\n * const { subscribe, isLoading, isSuccess, message } = useNewsletter({\n *   endpoint: '/api/newsletter/subscribe',\n *   source: 'custom-form',\n *   onSuccess: (email) => {\n *     analytics.track('newsletter_subscribed', { email });\n *   },\n * });\n * \n * const handleSubmit = async (email: string) => {\n *   const success = await subscribe(email);\n *   if (success) {\n *     // Show confetti or something\n *   }\n * };\n * ```\n */\nexport function useNewsletter(options: UseNewsletterOptions = {}): UseNewsletterReturn {\n  const {\n    endpoint = '/api/newsletter/subscribe',\n    source,\n    tags,\n    metadata,\n    onSuccess,\n    onError,\n  } = options;\n\n  const [state, setState] = useState<UseNewsletterState>({\n    status: 'idle',\n    message: '',\n    email: null,\n  });\n\n  const subscribe = useCallback(\n    async (email: string): Promise<boolean> => {\n      if (!email || !email.includes('@')) {\n        const errorMsg = 'Please enter a valid email address.';\n        setState({\n          status: 'error',\n          message: errorMsg,\n          email,\n        });\n        onError?.(errorMsg);\n        return false;\n      }\n\n      setState({ status: 'loading', message: '', email });\n\n      try {\n        const response = await fetch(endpoint, {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify({\n            email,\n            source,\n            tags,\n            metadata,\n          }),\n        });\n\n        const data = await response.json();\n\n        if (response.ok && data.success) {\n          const message = data.message || 'Thanks for subscribing!';\n          setState({\n            status: 'success',\n            message,\n            email,\n          });\n          onSuccess?.(email, message);\n          return true;\n        } else {\n          const message = data.message || 'Something went wrong. Please try again.';\n          setState({\n            status: 'error',\n            message,\n            email,\n          });\n          onError?.(message);\n          return false;\n        }\n      } catch (error) {\n        const message = 'Network error. Please try again.';\n        setState({\n          status: 'error',\n          message,\n          email,\n        });\n        onError?.(message);\n        return false;\n      }\n    },\n    [endpoint, source, tags, metadata, onSuccess, onError]\n  );\n\n  const reset = useCallback(() => {\n    setState({\n      status: 'idle',\n      message: '',\n      email: null,\n    });\n  }, []);\n\n  return {\n    ...state,\n    subscribe,\n    reset,\n    isLoading: state.status === 'loading',\n    isSuccess: state.status === 'success',\n    isError: state.status === 'error',\n  };\n}\n"],"mappings":"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","names":["Fragment","jsx","jsxs","useState","useCallback"]}

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+import { R as RateLimitConfig } from './types-BmajlhNp.js';
+export { A as APIResponse, C as ConfirmResult, E as EmailAdapter, a as EmailAdapterConfig, b as EmailTemplates, N as NewsletterConfig, c as NewsletterFormProps, d as NewsletterFormState, S as StorageAdapter, e as SubscribeInput, f as SubscribeRequest, g as SubscribeResult, h as Subscriber, i as SubscriptionStatus, U as UnsubscribeResult } from './types-BmajlhNp.js';
+export { NewsletterHandlers, createNewsletterHandlers } from './server/index.js';
+export { NewsletterBlock, NewsletterCard, NewsletterFooter, NewsletterForm, NewsletterInline, NewsletterModalContent, useNewsletter } from './components/index.js';
+export { createMailchimpAdapter, createMailchimpStorageAdapter, createNodemailerAdapter, createResendAdapter } from './adapters/email/index.js';
+export { createMemoryAdapter, createNoopAdapter, createPrismaAdapter, createSupabaseAdapter } from './adapters/storage/index.js';
+import 'react/jsx-runtime';
+
+/**
+ * Generate a secure random token for email confirmation
+ */
+declare function generateToken(length?: number): string;
+/**
+ * Generate a URL-safe token
+ */
+declare function generateUrlSafeToken(length?: number): string;
+
+/**
+ * Validate email format
+ * Uses a reasonable regex that catches most issues without being overly strict
+ */
+declare function isValidEmail(email: string): boolean;
+/**
+ * Normalize email address
+ * - Lowercase
+ * - Trim whitespace
+ * - Remove dots from Gmail local part (optional)
+ */
+declare function normalizeEmail(email: string, options?: {
+    normalizeGmail?: boolean;
+}): string;
+declare function isDisposableEmail(email: string): boolean;
+/**
+ * Sanitize string input to prevent XSS
+ */
+declare function sanitizeString(input: string): string;
+
+/**
+ * Simple in-memory rate limiter
+ *
+ * For production with multiple server instances, consider:
+ * - Redis-based rate limiting
+ * - Upstash Ratelimit
+ * - Arcjet
+ */
+declare function createRateLimiter(config: RateLimitConfig): {
+    /**
+     * Check if request should be rate limited
+     * Returns true if request is allowed, false if rate limited
+     */
+    check(req: Request): Promise<{
+        allowed: boolean;
+        remaining: number;
+        resetAt: Date;
+    }>;
+    /**
+     * Get current limit status without incrementing
+     */
+    status(req: Request): Promise<{
+        remaining: number;
+        resetAt: Date | null;
+    }>;
+    /**
+     * Reset rate limit for an identifier
+     */
+    reset(req: Request): Promise<void>;
+};
+/**
+ * Extract client IP from request
+ */
+declare function getClientIP(req: Request): string;
+
+export { RateLimitConfig, createRateLimiter, generateToken, generateUrlSafeToken, getClientIP, isDisposableEmail, isValidEmail, normalizeEmail, sanitizeString };