betterstart-cli 0.0.1

package/README.md

@@ -0,0 +1,5 @@
+# @betterstart/cli
+
+Plugin- and integration-based BetterStart Admin CLI.
+
+> **Warning:** This project is a work in progress. Expect bugs, breaking changes, and incomplete features.

package/dist/assets/adapters/next/integrations/mailchimp/actions/mailchimp.ts

@@ -0,0 +1,38 @@
+import mailchimp from '@mailchimp/mailchimp_marketing'
+
+if (process.env.BETTERSTART_MAILCHIMP_API_KEY && process.env.BETTERSTART_MAILCHIMP_SERVER_PREFIX) {
+  mailchimp.setConfig({
+    apiKey: process.env.BETTERSTART_MAILCHIMP_API_KEY,
+    server: process.env.BETTERSTART_MAILCHIMP_SERVER_PREFIX
+  })
+}
+
+/**
+ * Add an email address to the Mailchimp audience (fire-and-forget, non-blocking)
+ * Follows the same pattern as sendWebhook() in utils/webhook/webhook.ts
+ */
+export function addToMailchimpAudience(email: string): void {
+  if (
+    !process.env.BETTERSTART_MAILCHIMP_API_KEY ||
+    !process.env.BETTERSTART_MAILCHIMP_SERVER_PREFIX ||
+    !process.env.BETTERSTART_MAILCHIMP_AUDIENCE_ID
+  )
+    return
+
+  ;(async () => {
+    try {
+      await mailchimp.lists.addListMember(process.env.BETTERSTART_MAILCHIMP_AUDIENCE_ID!, {
+        email_address: email,
+        status: 'subscribed' as const,
+        merge_fields: {}
+      })
+    } catch (error: unknown) {
+      if (
+        (error as { response?: { body?: { title?: string } } })?.response?.body?.title ===
+        'Member Exists'
+      )
+        return
+      console.error('Failed to add to Mailchimp audience:', error)
+    }
+  })()
+}

package/dist/assets/adapters/next/integrations/mailchimp/integration.ts

@@ -0,0 +1,33 @@
+import type { BetterstartIntegrationDefinition } from '@integration-engine/types.js'
+
+export const mailchimpIntegration: BetterstartIntegrationDefinition = {
+  id: 'mailchimp',
+  title: 'Mailchimp',
+  description: 'Mailchimp audience sync for form submissions',
+  kind: 'form',
+  version: '1.0.0',
+  dependencies: [],
+  conflicts: [],
+  files: [
+    {
+      outputPath: 'lib/actions/mailchimp/add-to-mailchimp-audience.ts',
+      templatePath: 'actions/mailchimp.ts'
+    }
+  ],
+  packageDependencies: ['@mailchimp/mailchimp_marketing'],
+  devDependencies: ['@types/mailchimp__mailchimp_marketing'],
+  capabilities: {
+    formFeatures: ['mailchimp']
+  },
+  envSections: [
+    {
+      header: 'Mailchimp',
+      vars: [
+        { key: 'BETTERSTART_MAILCHIMP_API_KEY', value: '' },
+        { key: 'BETTERSTART_MAILCHIMP_SERVER_PREFIX', value: '' },
+        { key: 'BETTERSTART_MAILCHIMP_AUDIENCE_ID', value: '' }
+      ]
+    }
+  ],
+  configure: 'none'
+}

package/dist/assets/adapters/next/integrations/r2/actions/r2.ts

@@ -0,0 +1,77 @@
+import { randomUUID } from 'node:crypto'
+import type { AdminStorageProvider, AdminStorageUploadInput } from '@admin/actions/storage/types'
+import { PutObjectCommand, S3Client } from '@aws-sdk/client-s3'
+
+let r2Client: S3Client | null = null
+
+function getConfig() {
+  return {
+    accountId: process.env.BETTERSTART_R2_ACCOUNT_ID?.trim() ?? '',
+    accessKeyId: process.env.BETTERSTART_R2_ACCESS_KEY_ID?.trim() ?? '',
+    secretAccessKey: process.env.BETTERSTART_R2_SECRET_ACCESS_KEY?.trim() ?? '',
+    bucketName: process.env.BETTERSTART_R2_BUCKET_NAME?.trim() ?? '',
+    publicUrl: process.env.BETTERSTART_R2_PUBLIC_URL?.trim() ?? ''
+  }
+}
+
+function sanitizeFilename(filename: string): string {
+  return filename.replace(/[^a-zA-Z0-9.-]/g, '_')
+}
+
+function buildKey(filename: string, prefix = 'uploads'): string {
+  return `${prefix}/${Date.now()}-${randomUUID()}-${sanitizeFilename(filename)}`
+}
+
+function getClient(): S3Client {
+  if (r2Client) {
+    return r2Client
+  }
+
+  const config = getConfig()
+  r2Client = new S3Client({
+    region: 'auto',
+    endpoint: `https://${config.accountId}.r2.cloudflarestorage.com`,
+    credentials: {
+      accessKeyId: config.accessKeyId,
+      secretAccessKey: config.secretAccessKey
+    }
+  })
+
+  return r2Client
+}
+
+export const r2StorageProvider: AdminStorageProvider = {
+  id: 'r2',
+  isConfigured() {
+    const config = getConfig()
+    return Boolean(
+      config.accountId &&
+        config.accessKeyId &&
+        config.secretAccessKey &&
+        config.bucketName &&
+        config.publicUrl
+    )
+  },
+  async saveFile(input: AdminStorageUploadInput) {
+    const config = getConfig()
+    if (!this.isConfigured()) {
+      throw new Error('Cloudflare R2 is not fully configured.')
+    }
+
+    const key = buildKey(input.filename, input.prefix)
+    await getClient().send(
+      new PutObjectCommand({
+        Bucket: config.bucketName,
+        Key: key,
+        Body: input.buffer,
+        ContentType: input.contentType,
+        ContentLength: input.contentLength
+      })
+    )
+
+    return {
+      key,
+      url: `${config.publicUrl.replace(/\/$/, '')}/${key}`
+    }
+  }
+}

package/dist/assets/adapters/next/integrations/r2/integration.ts

@@ -0,0 +1,39 @@
+import type { BetterstartIntegrationDefinition } from '@integration-engine/types.js'
+
+export const r2Integration: BetterstartIntegrationDefinition = {
+  id: 'r2',
+  title: 'Cloudflare R2',
+  description: 'Remote media storage for hosted deployments',
+  kind: 'storage',
+  version: '1.0.0',
+  dependencies: [],
+  conflicts: [],
+  files: [
+    {
+      outputPath: 'lib/actions/r2/provider.ts',
+      templatePath: 'actions/r2.ts'
+    }
+  ],
+  packageDependencies: ['@aws-sdk/client-s3'],
+  devDependencies: [],
+  capabilities: {
+    storageProvider: {
+      provider: 'r2',
+      importPath: '@admin/actions/r2/provider',
+      exportName: 'r2StorageProvider'
+    }
+  },
+  envSections: [
+    {
+      header: 'Storage (Cloudflare R2)',
+      vars: [
+        { key: 'BETTERSTART_R2_ACCOUNT_ID', value: '' },
+        { key: 'BETTERSTART_R2_ACCESS_KEY_ID', value: '' },
+        { key: 'BETTERSTART_R2_SECRET_ACCESS_KEY', value: '' },
+        { key: 'BETTERSTART_R2_BUCKET_NAME', value: '' },
+        { key: 'BETTERSTART_R2_PUBLIC_URL', value: '' }
+      ]
+    }
+  ],
+  configure: 'r2'
+}

package/dist/assets/adapters/next/integrations/resend/actions/resend.ts

@@ -0,0 +1,138 @@
+import type {
+  AdminEmailProvider,
+  PasswordResetEmailInput,
+  SendEmailInput,
+  SendEmailResult
+} from '@admin/actions/email/types'
+import { Resend } from 'resend'
+
+const NOT_CONFIGURED_REASON =
+  'Resend email delivery requires BETTERSTART_RESEND_API_KEY and BETTERSTART_EMAIL_FROM.'
+
+let cachedClient: Resend | null = null
+let cachedApiKey: string | null = null
+
+function getEnvValue(key: string): string | null {
+  const value = process.env[key]?.trim()
+  return value && value.length > 0 ? value : null
+}
+
+function getFromAddress(): string | null {
+  return getEnvValue('BETTERSTART_EMAIL_FROM')
+}
+
+function getResendClient(): Resend | null {
+  const apiKey = getEnvValue('BETTERSTART_RESEND_API_KEY')
+  if (!apiKey) {
+    return null
+  }
+
+  if (!cachedClient || cachedApiKey !== apiKey) {
+    cachedClient = new Resend(apiKey)
+    cachedApiKey = apiKey
+  }
+
+  return cachedClient
+}
+
+function isConfigured(): boolean {
+  return Boolean(getResendClient() && getFromAddress())
+}
+
+function htmlToText(html: string): string {
+  return html
+    .replace(/<style[\s\S]*?<\/style>/gi, '')
+    .replace(/<script[\s\S]*?<\/script>/gi, '')
+    .replace(/<br\s*\/?>/gi, '\n')
+    .replace(/<\/(p|div|h[1-6]|li|tr)>/gi, '\n')
+    .replace(/<[^>]+>/g, '')
+    .replace(/&nbsp;/g, ' ')
+    .replace(/&amp;/g, '&')
+    .replace(/&lt;/g, '<')
+    .replace(/&gt;/g, '>')
+    .replace(/&quot;/g, '"')
+    .replace(/&#39;/g, "'")
+    .replace(/\n{3,}/g, '\n\n')
+    .trim()
+}
+
+async function sendEmail(input: SendEmailInput): Promise<SendEmailResult> {
+  const client = getResendClient()
+  const from = getFromAddress()
+
+  if (!client || !from) {
+    return {
+      delivered: false,
+      reason: NOT_CONFIGURED_REASON
+    }
+  }
+
+  try {
+    const result = await client.emails.send({
+      from,
+      to: input.to,
+      subject: input.subject,
+      html: input.html,
+      text: htmlToText(input.html)
+    })
+
+    if (result.error) {
+      return {
+        delivered: false,
+        reason: result.error.message
+      }
+    }
+
+    return { delivered: true }
+  } catch (error) {
+    return {
+      delivered: false,
+      reason: error instanceof Error ? error.message : 'Resend email delivery failed.'
+    }
+  }
+}
+
+function escapeHtml(value: string): string {
+  return value
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;')
+}
+
+function renderPasswordResetEmail(input: PasswordResetEmailInput): string {
+  const displayName = input.user.name?.trim() || input.user.email
+  const escapedName = escapeHtml(displayName)
+  const escapedUrl = escapeHtml(input.url)
+
+  return `<!doctype html>
+<html>
+  <body style="margin:0;background:#f8fafc;font-family:Inter,-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;color:#0f172a;">
+    <div style="margin:0 auto;max-width:560px;padding:40px 20px;">
+      <div style="border-radius:12px;background:#ffffff;padding:32px;border:1px solid #e2e8f0;">
+        <h1 style="margin:0 0 16px;font-size:24px;line-height:32px;">Reset your password</h1>
+        <p style="margin:0 0 16px;font-size:16px;line-height:24px;">Hi ${escapedName},</p>
+        <p style="margin:0 0 24px;font-size:16px;line-height:24px;">Use the button below to reset your BetterStart Admin password.</p>
+        <p style="margin:0 0 24px;">
+          <a href="${escapedUrl}" style="display:inline-block;border-radius:8px;background:#0f172a;color:#ffffff;padding:12px 18px;text-decoration:none;font-weight:600;">Reset password</a>
+        </p>
+        <p style="margin:0;color:#64748b;font-size:14px;line-height:20px;">If you did not request this email, you can safely ignore it.</p>
+      </div>
+    </div>
+  </body>
+</html>`
+}
+
+export const resendEmailProvider: AdminEmailProvider = {
+  id: 'resend',
+  isConfigured,
+  sendEmail,
+  async sendPasswordResetEmail(input) {
+    return sendEmail({
+      to: input.user.email,
+      subject: 'Reset your password',
+      html: renderPasswordResetEmail(input)
+    })
+  }
+}

package/dist/assets/adapters/next/integrations/resend/integration.ts

@@ -0,0 +1,36 @@
+import type { BetterstartIntegrationDefinition } from '@integration-engine/types.js'
+
+export const resendIntegration: BetterstartIntegrationDefinition = {
+  id: 'resend',
+  title: 'Resend',
+  description: 'Email delivery for auth and form notifications',
+  kind: 'email',
+  version: '1.0.1',
+  dependencies: [],
+  conflicts: [],
+  files: [
+    {
+      outputPath: 'lib/actions/resend/provider.ts',
+      templatePath: 'actions/resend.ts'
+    }
+  ],
+  packageDependencies: ['resend'],
+  devDependencies: [],
+  capabilities: {
+    emailProvider: {
+      provider: 'resend',
+      importPath: '@admin/actions/resend/provider',
+      exportName: 'resendEmailProvider'
+    }
+  },
+  envSections: [
+    {
+      header: 'Email (Resend)',
+      vars: [
+        { key: 'BETTERSTART_RESEND_API_KEY', value: '' },
+        { key: 'BETTERSTART_EMAIL_FROM', value: 'noreply@yourdomain.com' }
+      ]
+    }
+  ],
+  configure: 'resend'
+}

package/dist/assets/adapters/next/plugins/blog/plugin.ts

@@ -0,0 +1,17 @@
+import type { BetterstartPluginDefinition } from '@plugin-engine/types.js'
+
+export const blogPlugin: BetterstartPluginDefinition = {
+  id: 'blog',
+  title: 'Blog',
+  description: 'Posts content module',
+  kind: 'content',
+  version: '1.0.0',
+  dependencies: [],
+  conflicts: [],
+  schemaFiles: ['posts.json'],
+  files: [],
+  packageDependencies: ['katex', 'markdown-it@^13.0.2', 'markdown-it-dollarmath', 'sanitize-html'],
+  devDependencies: ['@types/markdown-it@13', '@types/sanitize-html'],
+  envSections: [],
+  configure: 'none'
+}

package/dist/assets/adapters/next/plugins/blog/schemas/posts.json

@@ -0,0 +1,169 @@
+{
+  "name": "posts",
+  "label": "Posts",
+  "description": "Manage blog posts and articles",
+  "icon": "FileText",
+  "navGroup": {
+    "label": "Blog",
+    "position": 0
+  },
+  "navPosition": 0,
+  "slot": {
+    "main": {
+      "fields": [
+        {
+          "name": "title",
+          "type": "string",
+          "label": "Title",
+          "required": true
+        },
+        {
+          "name": "slug",
+          "type": "string",
+          "label": "Slug",
+          "hint": "URL-friendly identifier (auto-generated from title)"
+        },
+        {
+          "name": "excerpt",
+          "type": "text",
+          "label": "Excerpt",
+          "hint": "Short summary for the content"
+        },
+        {
+          "name": "content",
+          "type": "richtext",
+          "output": "html",
+          "height": "fill"
+        }
+      ]
+    },
+    "sidebar": {
+      "fields": [
+        {
+          "name": "generalSidebar",
+          "type": "section",
+          "heading": {
+            "icon": "bolt",
+            "title": "General"
+          },
+          "fields": [
+            {
+              "name": "coverImage",
+              "type": "image",
+              "label": "Cover Image"
+            },
+            {
+              "name": "categories",
+              "type": "select",
+              "label": "Categories",
+              "placeholder": "Select categories",
+              "hint": "Assign one or more categories",
+              "default": "category-1",
+              "creatable": true,
+              "multiple": true,
+              "previewLimit": 1,
+              "options": [
+                {
+                  "label": "Category 1",
+                  "value": "category-1"
+                },
+                {
+                  "label": "Category 2",
+                  "value": "category-2"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "seoSidebar",
+          "type": "section",
+          "heading": {
+            "icon": "globe",
+            "title": "SEO Settings"
+          },
+          "fields": [
+            {
+              "name": "openGraphImage",
+              "type": "image",
+              "label": "OpenGraph Image"
+            },
+            {
+              "name": "seoTitle",
+              "type": "string",
+              "label": "SEO Title",
+              "defaultValueFrom": "title",
+              "hint": "Overrides the post title in search results",
+              "length": 70
+            },
+            {
+              "name": "seoDescription",
+              "type": "text",
+              "label": "SEO Description",
+              "defaultValueFrom": "excerpt",
+              "hint": "Overrides the excerpt in search result snippets"
+            },
+            {
+              "name": "noIndex",
+              "type": "boolean",
+              "label": "No Index",
+              "hint": "Ask search engines not to index this post",
+              "default": false
+            },
+            {
+              "name": "noFollow",
+              "type": "boolean",
+              "label": "No Follow",
+              "hint": "Ask search engines not to follow links on this post",
+              "default": false
+            }
+          ]
+        }
+      ]
+    }
+  },
+  "columns": [
+    {
+      "accessorKey": "title",
+      "header": "Title",
+      "type": "text",
+      "sortable": true,
+      "size": "xl"
+    },
+    {
+      "accessorKey": "published",
+      "header": "Status",
+      "type": "boolean",
+      "sortable": true,
+      "size": "sm"
+    },
+    {
+      "accessorKey": "updatedAt",
+      "header": "Updated",
+      "type": "date",
+      "sortable": true,
+      "size": "sm"
+    },
+    {
+      "accessorKey": "createdAt",
+      "header": "Created",
+      "type": "date",
+      "sortable": true,
+      "size": "sm"
+    }
+  ],
+  "actions": {
+    "create": true,
+    "edit": true,
+    "delete": true,
+    "draft": true
+  },
+  "search": {
+    "fields": ["title", "excerpt"]
+  },
+  "autoSlugify": {
+    "enabled": true,
+    "sourceField": "title",
+    "targetField": "slug"
+  }
+}