arkaos 4.26.0 → 4.27.0

package/departments/marketing/tools/clis/plausible.js

@@ -0,0 +1,249 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.PLAUSIBLE_API_KEY
+const BASE_URL = process.env.PLAUSIBLE_BASE_URL || 'https://plausible.io'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'PLAUSIBLE_API_KEY environment variable required' }))
+  process.exit(1)
+}
+
+async function api(method, path, body) {
+  if (args['dry-run']) {
+    return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: { Authorization: '***', 'Content-Type': 'application/json', 'Accept': 'application/json' }, body: body || undefined }
+  }
+  const res = await fetch(`${BASE_URL}${path}`, {
+    method,
+    headers: {
+      'Authorization': `Bearer ${API_KEY}`,
+      'Content-Type': 'application/json',
+      'Accept': 'application/json',
+    },
+    body: body ? JSON.stringify(body) : undefined,
+  })
+  const text = await res.text()
+  try {
+    return JSON.parse(text)
+  } catch {
+    return { status: res.status, body: text }
+  }
+}
+
+function parseArgs(args) {
+  const result = { _: [] }
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i]
+    if (arg.startsWith('--')) {
+      const key = arg.slice(2)
+      const next = args[i + 1]
+      if (next && !next.startsWith('--')) {
+        result[key] = next
+        i++
+      } else {
+        result[key] = true
+      }
+    } else {
+      result._.push(arg)
+    }
+  }
+  return result
+}
+
+const args = parseArgs(process.argv.slice(2))
+const [cmd, sub, ...rest] = args._
+
+async function main() {
+  let result
+  const siteId = args['site-id']
+  const dateRange = args['date-range'] || '30d'
+  const limit = args.limit ? Number(args.limit) : 100
+
+  switch (cmd) {
+    case 'stats':
+      if (!siteId) { result = { error: '--site-id required (your domain, e.g. example.com)' }; break }
+      switch (sub) {
+        case 'aggregate': {
+          const metrics = args.metrics?.split(',') || ['visitors', 'pageviews', 'bounce_rate', 'visit_duration']
+          result = await api('POST', '/api/v2/query', {
+            site_id: siteId,
+            metrics,
+            date_range: dateRange,
+          })
+          break
+        }
+        case 'timeseries': {
+          const metrics = args.metrics?.split(',') || ['visitors', 'pageviews']
+          const period = args.period || 'time:day'
+          result = await api('POST', '/api/v2/query', {
+            site_id: siteId,
+            metrics,
+            date_range: dateRange,
+            dimensions: [period],
+          })
+          break
+        }
+        case 'pages': {
+          const metrics = args.metrics?.split(',') || ['visitors', 'pageviews']
+          result = await api('POST', '/api/v2/query', {
+            site_id: siteId,
+            metrics,
+            date_range: dateRange,
+            dimensions: ['event:page'],
+            pagination: { limit },
+          })
+          break
+        }
+        case 'sources': {
+          const metrics = args.metrics?.split(',') || ['visitors', 'bounce_rate']
+          result = await api('POST', '/api/v2/query', {
+            site_id: siteId,
+            metrics,
+            date_range: dateRange,
+            dimensions: ['visit:source'],
+            pagination: { limit },
+          })
+          break
+        }
+        case 'countries': {
+          const metrics = args.metrics?.split(',') || ['visitors', 'percentage']
+          result = await api('POST', '/api/v2/query', {
+            site_id: siteId,
+            metrics,
+            date_range: dateRange,
+            dimensions: ['visit:country'],
+            pagination: { limit },
+          })
+          break
+        }
+        case 'devices': {
+          const metrics = args.metrics?.split(',') || ['visitors', 'percentage']
+          result = await api('POST', '/api/v2/query', {
+            site_id: siteId,
+            metrics,
+            date_range: dateRange,
+            dimensions: ['visit:device'],
+            pagination: { limit },
+          })
+          break
+        }
+        case 'utm': {
+          const param = args.param || 'utm_source'
+          const metrics = args.metrics?.split(',') || ['visitors', 'bounce_rate']
+          result = await api('POST', '/api/v2/query', {
+            site_id: siteId,
+            metrics,
+            date_range: dateRange,
+            dimensions: [`visit:${param}`],
+            pagination: { limit },
+          })
+          break
+        }
+        case 'query': {
+          const metrics = args.metrics?.split(',')
+          if (!metrics) { result = { error: '--metrics required (comma-separated)' }; break }
+          const body = { site_id: siteId, metrics, date_range: dateRange }
+          if (args.dimensions) body.dimensions = args.dimensions.split(',')
+          if (args.filters) {
+            try { body.filters = JSON.parse(args.filters) } catch { result = { error: '--filters must be valid JSON' }; break }
+          }
+          body.pagination = { limit }
+          result = await api('POST', '/api/v2/query', body)
+          break
+        }
+        case 'realtime':
+          result = await api('GET', `/api/v1/stats/realtime/visitors?site_id=${encodeURIComponent(siteId)}`)
+          break
+        default:
+          result = { error: 'Unknown stats subcommand. Use: aggregate, timeseries, pages, sources, countries, devices, utm, query, realtime' }
+      }
+      break
+
+    case 'sites':
+      switch (sub) {
+        case 'list':
+          result = await api('GET', '/api/v1/sites')
+          break
+        case 'get': {
+          if (!siteId) { result = { error: '--site-id required' }; break }
+          result = await api('GET', `/api/v1/sites/${encodeURIComponent(siteId)}`)
+          break
+        }
+        case 'create': {
+          const domain = args.domain
+          if (!domain) { result = { error: '--domain required' }; break }
+          const body = { domain }
+          if (args.timezone) body.timezone = args.timezone
+          result = await api('POST', '/api/v1/sites', body)
+          break
+        }
+        case 'delete': {
+          if (!siteId) { result = { error: '--site-id required' }; break }
+          result = await api('DELETE', `/api/v1/sites/${encodeURIComponent(siteId)}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown sites subcommand. Use: list, get, create, delete' }
+      }
+      break
+
+    case 'goals':
+      if (!siteId) { result = { error: '--site-id required' }; break }
+      switch (sub) {
+        case 'list':
+          result = await api('GET', `/api/v1/sites/goals?site_id=${encodeURIComponent(siteId)}`)
+          break
+        case 'create': {
+          const goalType = args['goal-type']
+          if (!goalType) { result = { error: '--goal-type required (event or page)' }; break }
+          const body = { site_id: siteId, goal_type: goalType }
+          if (goalType === 'event') {
+            if (!args['event-name']) { result = { error: '--event-name required for event goals' }; break }
+            body.event_name = args['event-name']
+          } else if (goalType === 'page') {
+            if (!args['page-path']) { result = { error: '--page-path required for page goals' }; break }
+            body.page_path = args['page-path']
+          }
+          result = await api('PUT', '/api/v1/sites/goals', body)
+          break
+        }
+        case 'delete': {
+          const goalId = args['goal-id']
+          if (!goalId) { result = { error: '--goal-id required' }; break }
+          result = await api('DELETE', `/api/v1/sites/goals/${goalId}`, { site_id: siteId })
+          break
+        }
+        default:
+          result = { error: 'Unknown goals subcommand. Use: list, create, delete' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          stats: {
+            aggregate: 'stats aggregate --site-id <domain> [--date-range <30d>] [--metrics <m1,m2>]',
+            timeseries: 'stats timeseries --site-id <domain> [--date-range <30d>] [--period <time:day>]',
+            pages: 'stats pages --site-id <domain> [--date-range <30d>] [--limit <n>]',
+            sources: 'stats sources --site-id <domain> [--date-range <30d>]',
+            countries: 'stats countries --site-id <domain> [--date-range <30d>]',
+            devices: 'stats devices --site-id <domain> [--date-range <30d>]',
+            utm: 'stats utm --site-id <domain> [--param <utm_source>] [--date-range <30d>]',
+            query: 'stats query --site-id <domain> --metrics <m1,m2> [--dimensions <d1,d2>] [--filters <json>]',
+            realtime: 'stats realtime --site-id <domain>',
+          },
+          sites: 'sites [list | get --site-id <domain> | create --domain <domain> | delete --site-id <domain>]',
+          goals: 'goals [list | create --goal-type <event|page> --event-name <name> | delete --goal-id <id>] --site-id <domain>',
+          options: '--date-range <day|7d|30d|month|6mo|12mo|year> --limit <n>',
+          env: 'PLAUSIBLE_BASE_URL for self-hosted instances (default: https://plausible.io)',
+        }
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})

package/departments/marketing/tools/clis/postmark.js

@@ -0,0 +1,375 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.POSTMARK_API_KEY
+const BASE_URL = 'https://api.postmarkapp.com'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'POSTMARK_API_KEY environment variable required' }))
+  process.exit(1)
+}
+
+async function api(method, path, body, useAccountToken) {
+  if (args['dry-run']) {
+    const maskedHeaders = { 'Content-Type': 'application/json', 'Accept': 'application/json' }
+    if (useAccountToken) {
+      maskedHeaders['X-Postmark-Account-Token'] = '***'
+    } else {
+      maskedHeaders['X-Postmark-Server-Token'] = '***'
+    }
+    return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: maskedHeaders, body: body || undefined }
+  }
+  const headers = {
+    'Content-Type': 'application/json',
+    'Accept': 'application/json',
+  }
+  if (useAccountToken) {
+    headers['X-Postmark-Account-Token'] = API_KEY
+  } else {
+    headers['X-Postmark-Server-Token'] = API_KEY
+  }
+  const res = await fetch(`${BASE_URL}${path}`, {
+    method,
+    headers,
+    body: body ? JSON.stringify(body) : undefined,
+  })
+  const text = await res.text()
+  try {
+    return JSON.parse(text)
+  } catch {
+    return { status: res.status, body: text }
+  }
+}
+
+function parseArgs(args) {
+  const result = { _: [] }
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i]
+    if (arg.startsWith('--')) {
+      const key = arg.slice(2)
+      const next = args[i + 1]
+      if (next && !next.startsWith('--')) {
+        result[key] = next
+        i++
+      } else {
+        result[key] = true
+      }
+    } else {
+      result._.push(arg)
+    }
+  }
+  return result
+}
+
+const args = parseArgs(process.argv.slice(2))
+const [cmd, sub, ...rest] = args._
+
+async function main() {
+  let result
+
+  switch (cmd) {
+    case 'email':
+      switch (sub) {
+        case 'send': {
+          const from = args.from
+          const to = args.to
+          const subject = args.subject
+          if (!from) { result = { error: '--from required' }; break }
+          if (!to) { result = { error: '--to required' }; break }
+          if (!subject) { result = { error: '--subject required' }; break }
+          const body = {
+            From: from,
+            To: to,
+            Subject: subject,
+          }
+          if (args.html) body.HtmlBody = args.html
+          if (args.text) body.TextBody = args.text
+          if (!args.html && !args.text) body.TextBody = ''
+          if (args.tag) body.Tag = args.tag
+          if (args.stream) body.MessageStream = args.stream
+          if (args['track-opens']) body.TrackOpens = true
+          if (args['track-links']) body.TrackLinks = args['track-links']
+          if (args.cc) body.Cc = args.cc
+          if (args.bcc) body.Bcc = args.bcc
+          if (args['reply-to']) body.ReplyTo = args['reply-to']
+          result = await api('POST', '/email', body)
+          break
+        }
+        case 'send-template': {
+          const from = args.from
+          const to = args.to
+          const template = args.template
+          if (!from) { result = { error: '--from required' }; break }
+          if (!to) { result = { error: '--to required' }; break }
+          if (!template) { result = { error: '--template required (template ID or alias)' }; break }
+          const body = {
+            From: from,
+            To: to,
+            TemplateModel: {},
+          }
+          const templateNum = Number(template)
+          if (!isNaN(templateNum)) {
+            body.TemplateId = templateNum
+          } else {
+            body.TemplateAlias = template
+          }
+          if (args.model) {
+            const pairs = args.model.split(',')
+            for (const pair of pairs) {
+              const [k, v] = pair.split(':')
+              if (k && v) body.TemplateModel[k] = v
+            }
+          }
+          if (args.stream) body.MessageStream = args.stream
+          if (args.tag) body.Tag = args.tag
+          result = await api('POST', '/email/withTemplate', body)
+          break
+        }
+        case 'send-batch': {
+          const from = args.from
+          const to = args.to
+          const subject = args.subject
+          if (!from || !to || !subject) {
+            result = { error: '--from, --to (comma-separated), and --subject required' }; break
+          }
+          const recipients = to.split(',')
+          const messages = recipients.map(recipient => ({
+            From: from,
+            To: recipient.trim(),
+            Subject: subject,
+            TextBody: args.text || '',
+            HtmlBody: args.html || undefined,
+            MessageStream: args.stream || undefined,
+            Tag: args.tag || undefined,
+          }))
+          result = await api('POST', '/email/batch', messages)
+          break
+        }
+        default:
+          result = { error: 'Unknown email subcommand. Use: send, send-template, send-batch' }
+      }
+      break
+
+    case 'templates':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          params.set('Count', args.count || '100')
+          params.set('Offset', args.offset || '0')
+          if (args.type) params.set('TemplateType', args.type)
+          result = await api('GET', `/templates?${params.toString()}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required (template ID or alias)' }; break }
+          result = await api('GET', `/templates/${id}`)
+          break
+        }
+        case 'create': {
+          const name = args.name
+          if (!name) { result = { error: '--name required' }; break }
+          const body = {
+            Name: name,
+            Subject: args.subject || '',
+          }
+          if (args.html) body.HtmlBody = args.html
+          if (args.text) body.TextBody = args.text
+          if (args.alias) body.Alias = args.alias
+          if (args.type) body.TemplateType = args.type
+          result = await api('POST', '/templates', body)
+          break
+        }
+        case 'delete': {
+          const id = args.id
+          if (!id) { result = { error: '--id required (template ID or alias)' }; break }
+          result = await api('DELETE', `/templates/${id}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown templates subcommand. Use: list, get, create, delete' }
+      }
+      break
+
+    case 'bounces':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          params.set('count', args.count || '50')
+          params.set('offset', args.offset || '0')
+          if (args.type) params.set('type', args.type)
+          if (args.inactive) params.set('inactive', args.inactive)
+          if (args.email) params.set('emailFilter', args.email)
+          result = await api('GET', `/bounces?${params.toString()}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/bounces/${id}`)
+          break
+        }
+        case 'stats':
+          result = await api('GET', '/deliverystats')
+          break
+        case 'activate': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('PUT', `/bounces/${id}/activate`)
+          break
+        }
+        default:
+          result = { error: 'Unknown bounces subcommand. Use: list, get, stats, activate' }
+      }
+      break
+
+    case 'messages':
+      switch (sub) {
+        case 'outbound': {
+          const params = new URLSearchParams()
+          params.set('count', args.count || '50')
+          params.set('offset', args.offset || '0')
+          if (args.recipient) params.set('recipient', args.recipient)
+          if (args.tag) params.set('tag', args.tag)
+          if (args.status) params.set('status', args.status)
+          result = await api('GET', `/messages/outbound?${params.toString()}`)
+          break
+        }
+        case 'inbound': {
+          const params = new URLSearchParams()
+          params.set('count', args.count || '50')
+          params.set('offset', args.offset || '0')
+          if (args.recipient) params.set('recipient', args.recipient)
+          if (args.status) params.set('status', args.status)
+          result = await api('GET', `/messages/inbound?${params.toString()}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required (message ID)' }; break }
+          result = await api('GET', `/messages/outbound/${id}/details`)
+          break
+        }
+        default:
+          result = { error: 'Unknown messages subcommand. Use: outbound, inbound, get' }
+      }
+      break
+
+    case 'stats':
+      switch (sub) {
+        case 'overview': {
+          const params = new URLSearchParams()
+          if (args.tag) params.set('tag', args.tag)
+          if (args.from) params.set('fromdate', args.from)
+          if (args.to) params.set('todate', args.to)
+          result = await api('GET', `/stats/outbound?${params.toString()}`)
+          break
+        }
+        case 'sends': {
+          const params = new URLSearchParams()
+          if (args.tag) params.set('tag', args.tag)
+          if (args.from) params.set('fromdate', args.from)
+          if (args.to) params.set('todate', args.to)
+          result = await api('GET', `/stats/outbound/sends?${params.toString()}`)
+          break
+        }
+        case 'bounces': {
+          const params = new URLSearchParams()
+          if (args.tag) params.set('tag', args.tag)
+          if (args.from) params.set('fromdate', args.from)
+          if (args.to) params.set('todate', args.to)
+          result = await api('GET', `/stats/outbound/bounces?${params.toString()}`)
+          break
+        }
+        case 'opens': {
+          const params = new URLSearchParams()
+          if (args.tag) params.set('tag', args.tag)
+          if (args.from) params.set('fromdate', args.from)
+          if (args.to) params.set('todate', args.to)
+          result = await api('GET', `/stats/outbound/opens?${params.toString()}`)
+          break
+        }
+        case 'clicks': {
+          const params = new URLSearchParams()
+          if (args.tag) params.set('tag', args.tag)
+          if (args.from) params.set('fromdate', args.from)
+          if (args.to) params.set('todate', args.to)
+          result = await api('GET', `/stats/outbound/clicks?${params.toString()}`)
+          break
+        }
+        case 'spam': {
+          const params = new URLSearchParams()
+          if (args.tag) params.set('tag', args.tag)
+          if (args.from) params.set('fromdate', args.from)
+          if (args.to) params.set('todate', args.to)
+          result = await api('GET', `/stats/outbound/spam?${params.toString()}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown stats subcommand. Use: overview, sends, bounces, opens, clicks, spam' }
+      }
+      break
+
+    case 'server':
+      switch (sub) {
+        case 'get':
+          result = await api('GET', '/server')
+          break
+        default:
+          result = { error: 'Unknown server subcommand. Use: get' }
+      }
+      break
+
+    case 'suppressions':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args.stream) params.set('MessageStream', args.stream)
+          result = await api('GET', `/message-streams/${args.stream || 'outbound'}/suppressions/dump`)
+          break
+        }
+        case 'create': {
+          const email = args.email
+          if (!email) { result = { error: '--email required' }; break }
+          const stream = args.stream || 'outbound'
+          result = await api('POST', `/message-streams/${stream}/suppressions`, {
+            Suppressions: email.split(',').map(e => ({ EmailAddress: e.trim() }))
+          })
+          break
+        }
+        case 'delete': {
+          const email = args.email
+          if (!email) { result = { error: '--email required' }; break }
+          const stream = args.stream || 'outbound'
+          result = await api('POST', `/message-streams/${stream}/suppressions/delete`, {
+            Suppressions: email.split(',').map(e => ({ EmailAddress: e.trim() }))
+          })
+          break
+        }
+        default:
+          result = { error: 'Unknown suppressions subcommand. Use: list, create, delete' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          email: 'email [send --from <from> --to <to> --subject <subj> | send-template --from <from> --to <to> --template <id> | send-batch --from <from> --to <to1,to2> --subject <subj>]',
+          templates: 'templates [list | get --id <id> | create --name <name> | delete --id <id>]',
+          bounces: 'bounces [list | get --id <id> | stats | activate --id <id>]',
+          messages: 'messages [outbound | inbound | get --id <id>]',
+          stats: 'stats [overview | sends | bounces | opens | clicks | spam]',
+          server: 'server [get]',
+          suppressions: 'suppressions [list | create --email <email> | delete --email <email>]',
+          options: '--tag <tag> --from <date> --to <date> --stream <stream-id>',
+        }
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})