@btst/stack 5.0.0 → 5.2.0

package/dist/packages/stack/src/plugins/newsletter/api/plugin.cjs

@@ -0,0 +1,171 @@
+'use strict';
+
+const api = require('@btst/stack/plugins/api');
+const z = require('zod');
+const db = require('../db.cjs');
+const schemas = require('../schemas.cjs');
+const operations = require('./operations.cjs');
+
+const newsletterBackendPlugin = (options) => {
+  const base = new URL(options.unsubscribeBaseURL);
+  if (!["http:", "https:"].includes(base.protocol) || base.username || base.password || base.search || base.hash)
+    throw new Error(
+      "unsubscribeBaseURL must be an absolute HTTP(S) API namespace without credentials, query, or fragment"
+    );
+  if (options.doubleOptIn && !options.confirmationFrom && !options.hooks?.onConfirmationRequired)
+    throw new Error(
+      "Double opt-in requires confirmationFrom or hooks.onConfirmationRequired"
+    );
+  if (options.confirmationFrom) {
+    z.z.object({
+      email: z.z.email(),
+      name: z.z.string().max(200).refine((name) => !/[\r\n]/.test(name)).optional()
+    }).parse(options.confirmationFrom);
+  }
+  return api.defineBackendPlugin({
+    id: "newsletter",
+    dbPlugin: db.newsletterSchema,
+    operations: (adapter) => operations.createNewsletterOperations(adapter, options),
+    routes: (_adapter, _context, operations) => ({
+      listSubscribers: api.createEndpoint(
+        "/newsletter/subscribers",
+        { method: "GET", query: schemas.listSubscribersSchema, requireRequest: true },
+        operations.listSubscribers.route((ctx) => ctx.query)
+      ),
+      getSubscriber: api.createEndpoint(
+        "/newsletter/subscribers/:id",
+        { method: "GET", requireRequest: true },
+        operations.getSubscriber.route((ctx) => ({ id: ctx.params.id }))
+      ),
+      createSubscriber: api.createEndpoint(
+        "/newsletter/subscribers",
+        { method: "POST", body: schemas.createSubscriberSchema, requireRequest: true },
+        operations.createSubscriber.route((ctx) => ctx.body)
+      ),
+      updateSubscriber: api.createEndpoint(
+        "/newsletter/subscribers/:id",
+        { method: "PUT", body: schemas.updateSubscriberSchema, requireRequest: true },
+        operations.updateSubscriber.route((ctx) => ({
+          id: ctx.params.id,
+          data: ctx.body
+        }))
+      ),
+      deleteSubscriber: api.createEndpoint(
+        "/newsletter/subscribers/:id",
+        { method: "DELETE", requireRequest: true },
+        operations.deleteSubscriber.route((ctx) => ({ id: ctx.params.id }))
+      ),
+      importSubscribers: api.createEndpoint(
+        "/newsletter/subscribers/import",
+        { method: "POST", body: schemas.importSubscribersSchema, requireRequest: true },
+        operations.importSubscribers.route((ctx) => ctx.body)
+      ),
+      exportSubscribers: api.createEndpoint(
+        "/newsletter/subscribers/export",
+        { method: "GET", requireRequest: true },
+        operations.exportSubscribers.route(() => ({}))
+      ),
+      subscribe: api.createEndpoint(
+        "/newsletter/subscribe",
+        { method: "POST", body: schemas.subscribeSchema, requireRequest: true },
+        operations.subscribe.route((ctx) => ctx.body)
+      ),
+      confirmSubscription: api.createEndpoint(
+        "/newsletter/confirm",
+        { method: "GET", query: schemas.tokenSchema, requireRequest: true },
+        operations.confirmSubscription.route((ctx) => ctx.query)
+      ),
+      unsubscribe: api.createEndpoint(
+        "/newsletter/unsubscribe",
+        { method: "GET", query: schemas.tokenSchema, requireRequest: true },
+        operations.unsubscribe.route((ctx) => ctx.query)
+      ),
+      listCampaigns: api.createEndpoint(
+        "/newsletter/campaigns",
+        { method: "GET", query: schemas.listCampaignsSchema, requireRequest: true },
+        operations.listCampaigns.route((ctx) => ctx.query)
+      ),
+      getCampaign: api.createEndpoint(
+        "/newsletter/campaigns/:id",
+        { method: "GET", requireRequest: true },
+        operations.getCampaign.route((ctx) => ({ id: ctx.params.id }))
+      ),
+      createCampaign: api.createEndpoint(
+        "/newsletter/campaigns",
+        { method: "POST", body: schemas.createCampaignSchema, requireRequest: true },
+        operations.createCampaign.route((ctx) => ctx.body)
+      ),
+      updateCampaign: api.createEndpoint(
+        "/newsletter/campaigns/:id",
+        { method: "PUT", body: schemas.updateCampaignSchema, requireRequest: true },
+        operations.updateCampaign.route((ctx) => ({
+          id: ctx.params.id,
+          data: ctx.body
+        }))
+      ),
+      deleteCampaign: api.createEndpoint(
+        "/newsletter/campaigns/:id",
+        { method: "DELETE", requireRequest: true },
+        operations.deleteCampaign.route((ctx) => ({ id: ctx.params.id }))
+      ),
+      sendCampaign: api.createEndpoint(
+        "/newsletter/campaigns/:id/send",
+        { method: "POST", requireRequest: true },
+        operations.sendCampaign.route((ctx) => ({ id: ctx.params.id }))
+      ),
+      scheduleCampaign: api.createEndpoint(
+        "/newsletter/campaigns/:id/schedule",
+        { method: "POST", body: schemas.scheduleCampaignSchema, requireRequest: true },
+        operations.scheduleCampaign.route((ctx) => ({
+          id: ctx.params.id,
+          ...ctx.body
+        }))
+      ),
+      sendTestEmail: api.createEndpoint(
+        "/newsletter/campaigns/:id/test",
+        { method: "POST", body: schemas.testCampaignSchema, requireRequest: true },
+        operations.sendTestEmail.route((ctx) => ({
+          id: ctx.params.id,
+          ...ctx.body
+        }))
+      ),
+      getCampaignStats: api.createEndpoint(
+        "/newsletter/campaigns/:id/stats",
+        { method: "GET", requireRequest: true },
+        operations.getCampaignStats.route((ctx) => ({ id: ctx.params.id }))
+      ),
+      getSubscriberGrowth: api.createEndpoint(
+        "/newsletter/growth",
+        { method: "GET", requireRequest: true },
+        operations.getSubscriberGrowth.route(() => ({}))
+      ),
+      trackOpen: api.createEndpoint(
+        "/newsletter/track/open",
+        { method: "GET", query: schemas.tokenSchema, requireRequest: true },
+        operations.trackOpen.route((ctx) => ctx.query)
+      ),
+      trackClick: api.createEndpoint(
+        "/newsletter/track/click",
+        {
+          method: "GET",
+          query: schemas.tokenSchema.extend({
+            link: z.z.coerce.number().int().min(0).max(1e4)
+          }),
+          requireRequest: true
+        },
+        operations.trackClick.route((ctx) => ctx.query)
+      ),
+      sendTransactionalEmail: api.createEndpoint(
+        "/newsletter/send",
+        {
+          method: "POST",
+          body: schemas.transactionalEmailSchema,
+          requireRequest: true
+        },
+        operations.sendTransactionalEmail.route((ctx) => ctx.body)
+      )
+    })
+  });
+};
+
+exports.newsletterBackendPlugin = newsletterBackendPlugin;

package/dist/packages/stack/src/plugins/newsletter/api/plugin.mjs

@@ -0,0 +1,169 @@
+import { defineBackendPlugin, createEndpoint } from '@btst/stack/plugins/api';
+import { z } from 'zod';
+import { newsletterSchema } from '../db.mjs';
+import { transactionalEmailSchema, tokenSchema, testCampaignSchema, scheduleCampaignSchema, updateCampaignSchema, createCampaignSchema, listCampaignsSchema, subscribeSchema, importSubscribersSchema, updateSubscriberSchema, createSubscriberSchema, listSubscribersSchema } from '../schemas.mjs';
+import { createNewsletterOperations } from './operations.mjs';
+
+const newsletterBackendPlugin = (options) => {
+  const base = new URL(options.unsubscribeBaseURL);
+  if (!["http:", "https:"].includes(base.protocol) || base.username || base.password || base.search || base.hash)
+    throw new Error(
+      "unsubscribeBaseURL must be an absolute HTTP(S) API namespace without credentials, query, or fragment"
+    );
+  if (options.doubleOptIn && !options.confirmationFrom && !options.hooks?.onConfirmationRequired)
+    throw new Error(
+      "Double opt-in requires confirmationFrom or hooks.onConfirmationRequired"
+    );
+  if (options.confirmationFrom) {
+    z.object({
+      email: z.email(),
+      name: z.string().max(200).refine((name) => !/[\r\n]/.test(name)).optional()
+    }).parse(options.confirmationFrom);
+  }
+  return defineBackendPlugin({
+    id: "newsletter",
+    dbPlugin: newsletterSchema,
+    operations: (adapter) => createNewsletterOperations(adapter, options),
+    routes: (_adapter, _context, operations) => ({
+      listSubscribers: createEndpoint(
+        "/newsletter/subscribers",
+        { method: "GET", query: listSubscribersSchema, requireRequest: true },
+        operations.listSubscribers.route((ctx) => ctx.query)
+      ),
+      getSubscriber: createEndpoint(
+        "/newsletter/subscribers/:id",
+        { method: "GET", requireRequest: true },
+        operations.getSubscriber.route((ctx) => ({ id: ctx.params.id }))
+      ),
+      createSubscriber: createEndpoint(
+        "/newsletter/subscribers",
+        { method: "POST", body: createSubscriberSchema, requireRequest: true },
+        operations.createSubscriber.route((ctx) => ctx.body)
+      ),
+      updateSubscriber: createEndpoint(
+        "/newsletter/subscribers/:id",
+        { method: "PUT", body: updateSubscriberSchema, requireRequest: true },
+        operations.updateSubscriber.route((ctx) => ({
+          id: ctx.params.id,
+          data: ctx.body
+        }))
+      ),
+      deleteSubscriber: createEndpoint(
+        "/newsletter/subscribers/:id",
+        { method: "DELETE", requireRequest: true },
+        operations.deleteSubscriber.route((ctx) => ({ id: ctx.params.id }))
+      ),
+      importSubscribers: createEndpoint(
+        "/newsletter/subscribers/import",
+        { method: "POST", body: importSubscribersSchema, requireRequest: true },
+        operations.importSubscribers.route((ctx) => ctx.body)
+      ),
+      exportSubscribers: createEndpoint(
+        "/newsletter/subscribers/export",
+        { method: "GET", requireRequest: true },
+        operations.exportSubscribers.route(() => ({}))
+      ),
+      subscribe: createEndpoint(
+        "/newsletter/subscribe",
+        { method: "POST", body: subscribeSchema, requireRequest: true },
+        operations.subscribe.route((ctx) => ctx.body)
+      ),
+      confirmSubscription: createEndpoint(
+        "/newsletter/confirm",
+        { method: "GET", query: tokenSchema, requireRequest: true },
+        operations.confirmSubscription.route((ctx) => ctx.query)
+      ),
+      unsubscribe: createEndpoint(
+        "/newsletter/unsubscribe",
+        { method: "GET", query: tokenSchema, requireRequest: true },
+        operations.unsubscribe.route((ctx) => ctx.query)
+      ),
+      listCampaigns: createEndpoint(
+        "/newsletter/campaigns",
+        { method: "GET", query: listCampaignsSchema, requireRequest: true },
+        operations.listCampaigns.route((ctx) => ctx.query)
+      ),
+      getCampaign: createEndpoint(
+        "/newsletter/campaigns/:id",
+        { method: "GET", requireRequest: true },
+        operations.getCampaign.route((ctx) => ({ id: ctx.params.id }))
+      ),
+      createCampaign: createEndpoint(
+        "/newsletter/campaigns",
+        { method: "POST", body: createCampaignSchema, requireRequest: true },
+        operations.createCampaign.route((ctx) => ctx.body)
+      ),
+      updateCampaign: createEndpoint(
+        "/newsletter/campaigns/:id",
+        { method: "PUT", body: updateCampaignSchema, requireRequest: true },
+        operations.updateCampaign.route((ctx) => ({
+          id: ctx.params.id,
+          data: ctx.body
+        }))
+      ),
+      deleteCampaign: createEndpoint(
+        "/newsletter/campaigns/:id",
+        { method: "DELETE", requireRequest: true },
+        operations.deleteCampaign.route((ctx) => ({ id: ctx.params.id }))
+      ),
+      sendCampaign: createEndpoint(
+        "/newsletter/campaigns/:id/send",
+        { method: "POST", requireRequest: true },
+        operations.sendCampaign.route((ctx) => ({ id: ctx.params.id }))
+      ),
+      scheduleCampaign: createEndpoint(
+        "/newsletter/campaigns/:id/schedule",
+        { method: "POST", body: scheduleCampaignSchema, requireRequest: true },
+        operations.scheduleCampaign.route((ctx) => ({
+          id: ctx.params.id,
+          ...ctx.body
+        }))
+      ),
+      sendTestEmail: createEndpoint(
+        "/newsletter/campaigns/:id/test",
+        { method: "POST", body: testCampaignSchema, requireRequest: true },
+        operations.sendTestEmail.route((ctx) => ({
+          id: ctx.params.id,
+          ...ctx.body
+        }))
+      ),
+      getCampaignStats: createEndpoint(
+        "/newsletter/campaigns/:id/stats",
+        { method: "GET", requireRequest: true },
+        operations.getCampaignStats.route((ctx) => ({ id: ctx.params.id }))
+      ),
+      getSubscriberGrowth: createEndpoint(
+        "/newsletter/growth",
+        { method: "GET", requireRequest: true },
+        operations.getSubscriberGrowth.route(() => ({}))
+      ),
+      trackOpen: createEndpoint(
+        "/newsletter/track/open",
+        { method: "GET", query: tokenSchema, requireRequest: true },
+        operations.trackOpen.route((ctx) => ctx.query)
+      ),
+      trackClick: createEndpoint(
+        "/newsletter/track/click",
+        {
+          method: "GET",
+          query: tokenSchema.extend({
+            link: z.coerce.number().int().min(0).max(1e4)
+          }),
+          requireRequest: true
+        },
+        operations.trackClick.route((ctx) => ctx.query)
+      ),
+      sendTransactionalEmail: createEndpoint(
+        "/newsletter/send",
+        {
+          method: "POST",
+          body: transactionalEmailSchema,
+          requireRequest: true
+        },
+        operations.sendTransactionalEmail.route((ctx) => ctx.body)
+      )
+    })
+  });
+};
+
+export { newsletterBackendPlugin };

package/dist/packages/stack/src/plugins/newsletter/api/serializers.cjs

@@ -0,0 +1,33 @@
+'use strict';
+
+function serializeSubscriber(record) {
+  return {
+    id: record.id,
+    email: record.email,
+    name: record.name,
+    status: record.status,
+    tags: JSON.parse(record.tags || "[]"),
+    confirmedAt: record.confirmedAt ? new Date(record.confirmedAt).toISOString() : null,
+    createdAt: new Date(record.createdAt).toISOString()
+  };
+}
+function serializeCampaign(record) {
+  return {
+    id: record.id,
+    subject: record.subject,
+    fromName: record.fromName,
+    fromEmail: record.fromEmail,
+    replyTo: record.replyTo,
+    body: record.body,
+    format: record.format,
+    tags: JSON.parse(record.tags || "[]"),
+    status: record.status,
+    scheduledAt: record.scheduledAt ? new Date(record.scheduledAt).toISOString() : null,
+    sentAt: record.sentAt ? new Date(record.sentAt).toISOString() : null,
+    createdAt: new Date(record.createdAt).toISOString(),
+    updatedAt: new Date(record.updatedAt).toISOString()
+  };
+}
+
+exports.serializeCampaign = serializeCampaign;
+exports.serializeSubscriber = serializeSubscriber;

package/dist/packages/stack/src/plugins/newsletter/api/serializers.mjs

@@ -0,0 +1,30 @@
+function serializeSubscriber(record) {
+  return {
+    id: record.id,
+    email: record.email,
+    name: record.name,
+    status: record.status,
+    tags: JSON.parse(record.tags || "[]"),
+    confirmedAt: record.confirmedAt ? new Date(record.confirmedAt).toISOString() : null,
+    createdAt: new Date(record.createdAt).toISOString()
+  };
+}
+function serializeCampaign(record) {
+  return {
+    id: record.id,
+    subject: record.subject,
+    fromName: record.fromName,
+    fromEmail: record.fromEmail,
+    replyTo: record.replyTo,
+    body: record.body,
+    format: record.format,
+    tags: JSON.parse(record.tags || "[]"),
+    status: record.status,
+    scheduledAt: record.scheduledAt ? new Date(record.scheduledAt).toISOString() : null,
+    sentAt: record.sentAt ? new Date(record.sentAt).toISOString() : null,
+    createdAt: new Date(record.createdAt).toISOString(),
+    updatedAt: new Date(record.updatedAt).toISOString()
+  };
+}
+
+export { serializeCampaign, serializeSubscriber };

package/dist/packages/stack/src/plugins/newsletter/client/components/markdown-preview.cjs

@@ -0,0 +1,17 @@
+"use client";
+'use strict';
+
+const jsxRuntime = require('react/jsx-runtime');
+const ReactMarkdown = require('react-markdown');
+const remarkGfm = require('remark-gfm');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const ReactMarkdown__default = /*#__PURE__*/_interopDefaultCompat(ReactMarkdown);
+const remarkGfm__default = /*#__PURE__*/_interopDefaultCompat(remarkGfm);
+
+function NewsletterMarkdownPreview({ markdown }) {
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "markdown-content", children: /* @__PURE__ */ jsxRuntime.jsx("div", { className: "markdown-inner", children: /* @__PURE__ */ jsxRuntime.jsx("div", { className: "markdown-body", children: /* @__PURE__ */ jsxRuntime.jsx(ReactMarkdown__default, { skipHtml: true, remarkPlugins: [remarkGfm__default], children: markdown }) }) }) });
+}
+
+exports.NewsletterMarkdownPreview = NewsletterMarkdownPreview;

package/dist/packages/stack/src/plugins/newsletter/client/components/markdown-preview.mjs

@@ -0,0 +1,10 @@
+"use client";
+import { jsx } from 'react/jsx-runtime';
+import ReactMarkdown from 'react-markdown';
+import remarkGfm from 'remark-gfm';
+
+function NewsletterMarkdownPreview({ markdown }) {
+  return /* @__PURE__ */ jsx("div", { className: "markdown-content", children: /* @__PURE__ */ jsx("div", { className: "markdown-inner", children: /* @__PURE__ */ jsx("div", { className: "markdown-body", children: /* @__PURE__ */ jsx(ReactMarkdown, { skipHtml: true, remarkPlugins: [remarkGfm], children: markdown }) }) }) });
+}
+
+export { NewsletterMarkdownPreview };

package/dist/packages/stack/src/plugins/newsletter/client/components/pages/campaign-stats-page.internal.cjs

@@ -0,0 +1,70 @@
+"use client";
+'use strict';
+
+const jsxRuntime = require('react/jsx-runtime');
+const plugins_newsletter_client_hooks_index = require('../../../../../../../../plugins/newsletter/client/hooks/index.cjs');
+const shared = require('../shared.cjs');
+
+function CampaignStatsPage({ id }) {
+  const { data: campaign } = plugins_newsletter_client_hooks_index.useCampaign(id);
+  const { data: stats } = plugins_newsletter_client_hooks_index.useCampaignStats(id);
+  const metrics = [
+    ["Recipients", stats.recipientCount],
+    ["Delivered", stats.delivered],
+    ["Opened", stats.opened],
+    ["Clicked", stats.clicked],
+    ["Bounced", stats.bounced],
+    ["Failed", stats.failed]
+  ];
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    shared.NewsletterPage,
+    {
+      title: campaign.subject,
+      description: "Delivery and engagement for this campaign.",
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-wrap items-center gap-3", children: [
+          /* @__PURE__ */ jsxRuntime.jsx(shared.Status, { value: campaign.status }),
+          campaign.sentAt && /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "text-sm text-muted-foreground", children: [
+            "Sent ",
+            new Date(campaign.sentAt).toLocaleString()
+          ] })
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsx("dl", { className: "grid grid-cols-2 gap-x-8 gap-y-6 border-y py-6 sm:grid-cols-3 lg:grid-cols-6", children: metrics.map(([label, value]) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-2", children: [
+          /* @__PURE__ */ jsxRuntime.jsx("dt", { className: "text-sm text-muted-foreground", children: label }),
+          /* @__PURE__ */ jsxRuntime.jsx("dd", { className: "text-3xl font-semibold tabular-nums", children: value.toLocaleString() })
+        ] }, label)) }),
+        /* @__PURE__ */ jsxRuntime.jsx("div", { className: "grid gap-8 sm:grid-cols-2", children: [
+          ["Open rate", stats.openRate],
+          ["Click rate", stats.clickRate]
+        ].map(([label, value]) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-3", children: [
+          /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-baseline justify-between gap-4", children: [
+            /* @__PURE__ */ jsxRuntime.jsx("h2", { className: "font-medium", children: label }),
+            /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "text-2xl font-semibold tabular-nums", children: [
+              (Number(value) * 100).toFixed(1),
+              "%"
+            ] })
+          ] }),
+          /* @__PURE__ */ jsxRuntime.jsx(
+            "div",
+            {
+              className: "h-2 overflow-hidden rounded-full bg-muted",
+              "aria-hidden": "true",
+              children: /* @__PURE__ */ jsxRuntime.jsx(
+                "div",
+                {
+                  className: "h-full rounded-full bg-primary",
+                  style: {
+                    width: `${Math.max(0, Math.min(100, Number(value) * 100))}%`
+                  }
+                }
+              )
+            }
+          )
+        ] }, label)) }),
+        /* @__PURE__ */ jsxRuntime.jsx("p", { className: "max-w-2xl text-sm text-muted-foreground", children: "Delivered counts messages accepted by your email provider. Opens and clicks count unique recipients; email privacy settings and image blocking can affect open tracking." })
+      ]
+    }
+  );
+}
+
+exports.CampaignStatsPage = CampaignStatsPage;

package/dist/packages/stack/src/plugins/newsletter/client/components/pages/campaign-stats-page.internal.mjs

@@ -0,0 +1,68 @@
+"use client";
+import { jsxs, jsx } from 'react/jsx-runtime';
+import { useCampaign, useCampaignStats } from '../../../../../../../../plugins/newsletter/client/hooks/index.mjs';
+import { NewsletterPage, Status } from '../shared.mjs';
+
+function CampaignStatsPage({ id }) {
+  const { data: campaign } = useCampaign(id);
+  const { data: stats } = useCampaignStats(id);
+  const metrics = [
+    ["Recipients", stats.recipientCount],
+    ["Delivered", stats.delivered],
+    ["Opened", stats.opened],
+    ["Clicked", stats.clicked],
+    ["Bounced", stats.bounced],
+    ["Failed", stats.failed]
+  ];
+  return /* @__PURE__ */ jsxs(
+    NewsletterPage,
+    {
+      title: campaign.subject,
+      description: "Delivery and engagement for this campaign.",
+      children: [
+        /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-3", children: [
+          /* @__PURE__ */ jsx(Status, { value: campaign.status }),
+          campaign.sentAt && /* @__PURE__ */ jsxs("p", { className: "text-sm text-muted-foreground", children: [
+            "Sent ",
+            new Date(campaign.sentAt).toLocaleString()
+          ] })
+        ] }),
+        /* @__PURE__ */ jsx("dl", { className: "grid grid-cols-2 gap-x-8 gap-y-6 border-y py-6 sm:grid-cols-3 lg:grid-cols-6", children: metrics.map(([label, value]) => /* @__PURE__ */ jsxs("div", { className: "space-y-2", children: [
+          /* @__PURE__ */ jsx("dt", { className: "text-sm text-muted-foreground", children: label }),
+          /* @__PURE__ */ jsx("dd", { className: "text-3xl font-semibold tabular-nums", children: value.toLocaleString() })
+        ] }, label)) }),
+        /* @__PURE__ */ jsx("div", { className: "grid gap-8 sm:grid-cols-2", children: [
+          ["Open rate", stats.openRate],
+          ["Click rate", stats.clickRate]
+        ].map(([label, value]) => /* @__PURE__ */ jsxs("div", { className: "space-y-3", children: [
+          /* @__PURE__ */ jsxs("div", { className: "flex items-baseline justify-between gap-4", children: [
+            /* @__PURE__ */ jsx("h2", { className: "font-medium", children: label }),
+            /* @__PURE__ */ jsxs("p", { className: "text-2xl font-semibold tabular-nums", children: [
+              (Number(value) * 100).toFixed(1),
+              "%"
+            ] })
+          ] }),
+          /* @__PURE__ */ jsx(
+            "div",
+            {
+              className: "h-2 overflow-hidden rounded-full bg-muted",
+              "aria-hidden": "true",
+              children: /* @__PURE__ */ jsx(
+                "div",
+                {
+                  className: "h-full rounded-full bg-primary",
+                  style: {
+                    width: `${Math.max(0, Math.min(100, Number(value) * 100))}%`
+                  }
+                }
+              )
+            }
+          )
+        ] }, label)) }),
+        /* @__PURE__ */ jsx("p", { className: "max-w-2xl text-sm text-muted-foreground", children: "Delivered counts messages accepted by your email provider. Opens and clicks count unique recipients; email privacy settings and image blocking can affect open tracking." })
+      ]
+    }
+  );
+}
+
+export { CampaignStatsPage };

package/dist/packages/stack/src/plugins/newsletter/client/components/pages/campaigns-page.internal.cjs

@@ -0,0 +1,80 @@
+"use client";
+'use strict';
+
+const jsxRuntime = require('react/jsx-runtime');
+const React = require('react');
+const context = require('@btst/stack/context');
+const button = require('../../../../../../../ui/src/components/button.cjs');
+const plugins_newsletter_client_hooks_index = require('../../../../../../../../plugins/newsletter/client/hooks/index.cjs');
+const plugins_newsletter_permissions = require('../../../../../../../../plugins/newsletter/permissions.cjs');
+const constants = require('../../constants.cjs');
+const shared = require('../shared.cjs');
+
+function CampaignsPage() {
+  const [offset, setOffset] = React.useState(0);
+  const { data } = plugins_newsletter_client_hooks_index.useCampaigns({ limit: 25, offset });
+  const { Link, resolve } = context.usePluginSiteNavigation(constants.NEWSLETTER_PLUGIN_ID);
+  const { localization } = context.usePluginOverrides(constants.NEWSLETTER_PLUGIN_ID);
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    shared.NewsletterPage,
+    {
+      title: localization?.title ?? "Newsletter",
+      description: "Write to your subscribers. Follow each campaign from first draft to results.",
+      action: /* @__PURE__ */ jsxRuntime.jsx(context.PermissionAccess, { permission: plugins_newsletter_permissions.newsletterPermissions.campaign.create(), children: /* @__PURE__ */ jsxRuntime.jsx(button.Button, { asChild: true, children: /* @__PURE__ */ jsxRuntime.jsx(Link, { href: resolve("newsletter/campaigns/new").href, children: localization?.newCampaign ?? "New campaign" }) }) }),
+      children: [
+        data.items.length === 0 ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-3 py-10", children: [
+          /* @__PURE__ */ jsxRuntime.jsx("h2", { className: "text-xl font-medium", children: "Your first newsletter starts here" }),
+          /* @__PURE__ */ jsxRuntime.jsx("p", { className: "max-w-xl text-muted-foreground", children: "Create a campaign, choose your audience, and send yourself a test before sharing it." })
+        ] }) : /* @__PURE__ */ jsxRuntime.jsx("div", { className: "overflow-x-auto rounded-lg border", children: /* @__PURE__ */ jsxRuntime.jsxs("table", { className: "w-full min-w-[600px] text-left text-sm", children: [
+          /* @__PURE__ */ jsxRuntime.jsx("caption", { className: "sr-only", children: "Newsletter campaigns" }),
+          /* @__PURE__ */ jsxRuntime.jsx("thead", { className: "border-b bg-muted/40", children: /* @__PURE__ */ jsxRuntime.jsxs("tr", { children: [
+            /* @__PURE__ */ jsxRuntime.jsx("th", { className: "p-4 font-medium", children: "Subject" }),
+            /* @__PURE__ */ jsxRuntime.jsx("th", { className: "p-4 font-medium", children: "Status" }),
+            /* @__PURE__ */ jsxRuntime.jsx("th", { className: "p-4 font-medium", children: "Audience" }),
+            /* @__PURE__ */ jsxRuntime.jsx("th", { className: "p-4 font-medium", children: "Results" })
+          ] }) }),
+          /* @__PURE__ */ jsxRuntime.jsx("tbody", { children: data.items.map((campaign) => /* @__PURE__ */ jsxRuntime.jsxs("tr", { className: "border-b last:border-0", children: [
+            /* @__PURE__ */ jsxRuntime.jsxs("td", { className: "p-4", children: [
+              /* @__PURE__ */ jsxRuntime.jsx(
+                Link,
+                {
+                  className: "font-medium underline-offset-4 hover:underline",
+                  href: resolve(`newsletter/campaigns/${campaign.id}`).href,
+                  children: campaign.subject
+                }
+              ),
+              /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "mt-1 text-xs text-muted-foreground", children: [
+                campaign.fromName,
+                " <",
+                campaign.fromEmail,
+                ">"
+              ] })
+            ] }),
+            /* @__PURE__ */ jsxRuntime.jsxs("td", { className: "p-4", children: [
+              /* @__PURE__ */ jsxRuntime.jsx(shared.Status, { value: campaign.status }),
+              campaign.scheduledAt && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "mt-2 text-xs text-muted-foreground", children: new Date(campaign.scheduledAt).toLocaleString() })
+            ] }),
+            /* @__PURE__ */ jsxRuntime.jsx("td", { className: "p-4", children: campaign.tags.length ? campaign.tags.join(", ") : "All subscribers" }),
+            /* @__PURE__ */ jsxRuntime.jsx("td", { className: "p-4", children: /* @__PURE__ */ jsxRuntime.jsx(
+              context.PermissionAccess,
+              {
+                permission: plugins_newsletter_permissions.newsletterPermissions.analytics.read(),
+                children: /* @__PURE__ */ jsxRuntime.jsx(
+                  Link,
+                  {
+                    className: "underline underline-offset-4",
+                    href: resolve(`newsletter/campaigns/${campaign.id}/stats`).href,
+                    children: "View results"
+                  }
+                )
+              }
+            ) })
+          ] }, campaign.id)) })
+        ] }) }),
+        /* @__PURE__ */ jsxRuntime.jsx(shared.Pagination, { offset, total: data.total, onChange: setOffset })
+      ]
+    }
+  );
+}
+
+exports.CampaignsPage = CampaignsPage;