arkaos 4.26.0 → 4.28.0

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

@@ -0,0 +1,232 @@
+#!/usr/bin/env node
+
+const API_SECRET = process.env.KIT_API_SECRET
+const API_KEY = process.env.KIT_API_KEY
+const BASE_URL = 'https://api.convertkit.com/v3'
+
+if (!API_SECRET && !API_KEY) {
+  console.error(JSON.stringify({ error: 'KIT_API_SECRET or KIT_API_KEY environment variable required' }))
+  process.exit(1)
+}
+
+async function api(method, path, body, useSecret = true) {
+  const url = new URL(`${BASE_URL}${path}`)
+  if (method === 'GET' || method === 'DELETE') {
+    if (useSecret && API_SECRET) {
+      url.searchParams.set('api_secret', API_SECRET)
+    } else if (useSecret && !API_SECRET) {
+      return { error: 'KIT_API_SECRET required for this endpoint' }
+    } else if (API_KEY) {
+      url.searchParams.set('api_key', API_KEY)
+    }
+  }
+  const opts = {
+    method,
+    headers: { 'Content-Type': 'application/json' },
+  }
+  if (body && (method === 'POST' || method === 'PUT')) {
+    const authBody = { ...body }
+    if (useSecret && API_SECRET) {
+      authBody.api_secret = API_SECRET
+    } else if (useSecret && !API_SECRET) {
+      return { error: 'KIT_API_SECRET required for this endpoint' }
+    } else if (API_KEY) {
+      authBody.api_key = API_KEY
+    }
+    opts.body = JSON.stringify(authBody)
+  }
+  if (args['dry-run']) {
+    const dryRunHeaders = { ...opts.headers }
+    const dryRunUrl = url.toString().replace(API_SECRET, '***').replace(API_KEY, '***')
+    let dryRunBody = undefined
+    if (opts.body) {
+      const parsed = JSON.parse(opts.body)
+      if (parsed.api_secret) parsed.api_secret = '***'
+      if (parsed.api_key) parsed.api_key = '***'
+      dryRunBody = parsed
+    }
+    return { _dry_run: true, method, url: dryRunUrl, headers: dryRunHeaders, body: dryRunBody }
+  }
+  const res = await fetch(url.toString(), opts)
+  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 'subscribers':
+      switch (sub) {
+        case 'list': {
+          const params = args.page ? `&page=${args.page}` : ''
+          result = await api('GET', `/subscribers?${params}`)
+          break
+        }
+        case 'get':
+          if (!rest[0]) { result = { error: 'Subscriber ID required' }; break }
+          result = await api('GET', `/subscribers/${rest[0]}`)
+          break
+        case 'update': {
+          if (!rest[0]) { result = { error: 'Subscriber ID required' }; break }
+          const body = {}
+          if (args['first-name']) body.first_name = args['first-name']
+          if (args.fields) {
+            try { body.fields = JSON.parse(args.fields) } catch { result = { error: 'Invalid JSON in --fields' }; break }
+          }
+          result = await api('PUT', `/subscribers/${rest[0]}`, body)
+          break
+        }
+        case 'unsubscribe': {
+          const body = { email: args.email }
+          result = await api('PUT', '/unsubscribe', body)
+          break
+        }
+        default:
+          result = { error: 'Unknown subscribers subcommand. Use: list, get, update, unsubscribe' }
+      }
+      break
+
+    case 'forms':
+      switch (sub) {
+        case 'list':
+          result = await api('GET', '/forms', null, false)
+          break
+        case 'subscribe': {
+          if (!rest[0]) { result = { error: 'Form ID required' }; break }
+          if (!args.email) { result = { error: '--email required' }; break }
+          const formId = rest[0]
+          const body = { email: args.email }
+          if (args['first-name']) body.first_name = args['first-name']
+          if (args.fields) {
+            try { body.fields = JSON.parse(args.fields) } catch { result = { error: 'Invalid JSON in --fields' }; break }
+          }
+          result = await api('POST', `/forms/${formId}/subscribe`, body, false)
+          break
+        }
+        default:
+          result = { error: 'Unknown forms subcommand. Use: list, subscribe' }
+      }
+      break
+
+    case 'sequences':
+      switch (sub) {
+        case 'list':
+          result = await api('GET', '/sequences', null, false)
+          break
+        case 'subscribe': {
+          if (!rest[0]) { result = { error: 'Sequence ID required' }; break }
+          if (!args.email) { result = { error: '--email required' }; break }
+          const sequenceId = rest[0]
+          const body = { email: args.email }
+          if (args['first-name']) body.first_name = args['first-name']
+          if (args.fields) {
+            try { body.fields = JSON.parse(args.fields) } catch { result = { error: 'Invalid JSON in --fields' }; break }
+          }
+          result = await api('POST', `/sequences/${sequenceId}/subscribe`, body, false)
+          break
+        }
+        default:
+          result = { error: 'Unknown sequences subcommand. Use: list, subscribe' }
+      }
+      break
+
+    case 'tags':
+      switch (sub) {
+        case 'list':
+          result = await api('GET', '/tags', null, false)
+          break
+        case 'subscribe': {
+          if (!rest[0]) { result = { error: 'Tag ID required' }; break }
+          if (!args.email) { result = { error: '--email required' }; break }
+          const tagId = rest[0]
+          const body = { email: args.email }
+          if (args['first-name']) body.first_name = args['first-name']
+          if (args.fields) {
+            try { body.fields = JSON.parse(args.fields) } catch { result = { error: 'Invalid JSON in --fields' }; break }
+          }
+          result = await api('POST', `/tags/${tagId}/subscribe`, body, false)
+          break
+        }
+        case 'remove': {
+          if (!rest[0]) { result = { error: 'Tag ID required' }; break }
+          const tagId = rest[0]
+          const subscriberId = rest[1] || args['subscriber-id']
+          if (!subscriberId) { result = { error: 'Subscriber ID required' }; break }
+          result = await api('DELETE', `/subscribers/${subscriberId}/tags/${tagId}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown tags subcommand. Use: list, subscribe, remove' }
+      }
+      break
+
+    case 'broadcasts':
+      switch (sub) {
+        case 'list': {
+          const params = args.page ? `&page=${args.page}` : ''
+          result = await api('GET', `/broadcasts?${params}`)
+          break
+        }
+        case 'create': {
+          if (!args.subject || !args.content) { result = { error: '--subject and --content required' }; break }
+          const body = {
+            subject: args.subject,
+            content: args.content,
+          }
+          if (args['email-layout-template']) body.email_layout_template = args['email-layout-template']
+          result = await api('POST', '/broadcasts', body)
+          break
+        }
+        default:
+          result = { error: 'Unknown broadcasts subcommand. Use: list, create' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          subscribers: 'subscribers [list|get|update|unsubscribe] [id] [--email <email>] [--first-name <name>] [--fields <json>] [--page <n>]',
+          forms: 'forms [list|subscribe] [form_id] [--email <email>] [--first-name <name>] [--fields <json>]',
+          sequences: 'sequences [list|subscribe] [sequence_id] [--email <email>] [--first-name <name>] [--fields <json>]',
+          tags: 'tags [list|subscribe|remove] [tag_id] [subscriber_id] [--email <email>] [--subscriber-id <id>]',
+          broadcasts: 'broadcasts [list|create] [--subject <subject>] [--content <html>] [--email-layout-template <template>] [--page <n>]',
+        }
+      }
+  }
+
+  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/klaviyo.js

@@ -0,0 +1,348 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.KLAVIYO_API_KEY
+const BASE_URL = 'https://a.klaviyo.com/api'
+const REVISION = '2024-10-15'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'KLAVIYO_API_KEY environment variable required' }))
+  process.exit(1)
+}
+
+async function api(method, path, body) {
+  const headers = {
+    'Authorization': `Klaviyo-API-Key ${API_KEY}`,
+    'Content-Type': 'application/json',
+    'Accept': 'application/json',
+    'revision': REVISION,
+  }
+  if (args['dry-run']) {
+    return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: { ...headers, Authorization: '***' }, body: body || undefined }
+  }
+  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 'profiles':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args.filter) params.set('filter', args.filter)
+          if (args.sort) params.set('sort', args.sort)
+          if (args['page-size']) params.set('page[size]', args['page-size'])
+          if (args['page-cursor']) params.set('page[cursor]', args['page-cursor'])
+          const qs = params.toString()
+          result = await api('GET', `/profiles/${qs ? '?' + qs : ''}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/profiles/${id}/`)
+          break
+        }
+        case 'create': {
+          const email = args.email
+          if (!email) { result = { error: '--email required' }; break }
+          const attributes = { email }
+          if (args['first-name']) attributes.first_name = args['first-name']
+          if (args['last-name']) attributes.last_name = args['last-name']
+          if (args.phone) attributes.phone_number = args.phone
+          result = await api('POST', '/profiles/', {
+            data: { type: 'profile', attributes }
+          })
+          break
+        }
+        case 'update': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          const attributes = {}
+          if (args.email) attributes.email = args.email
+          if (args['first-name']) attributes.first_name = args['first-name']
+          if (args['last-name']) attributes.last_name = args['last-name']
+          if (args.phone) attributes.phone_number = args.phone
+          result = await api('PATCH', `/profiles/${id}/`, {
+            data: { type: 'profile', id, attributes }
+          })
+          break
+        }
+        default:
+          result = { error: 'Unknown profiles subcommand. Use: list, get, create, update' }
+      }
+      break
+
+    case 'lists':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args['page-size']) params.set('page[size]', args['page-size'])
+          const qs = params.toString()
+          result = await api('GET', `/lists/${qs ? '?' + qs : ''}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/lists/${id}/`)
+          break
+        }
+        case 'create': {
+          const name = args.name
+          if (!name) { result = { error: '--name required' }; break }
+          result = await api('POST', '/lists/', {
+            data: { type: 'list', attributes: { name } }
+          })
+          break
+        }
+        case 'delete': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('DELETE', `/lists/${id}/`)
+          break
+        }
+        case 'add-profiles': {
+          const id = args.id
+          if (!id) { result = { error: '--id required (list ID)' }; break }
+          const profileIds = args.profiles?.split(',')
+          if (!profileIds) { result = { error: '--profiles required (comma-separated profile IDs)' }; break }
+          result = await api('POST', `/lists/${id}/relationships/profiles/`, {
+            data: profileIds.map(pid => ({ type: 'profile', id: pid }))
+          })
+          break
+        }
+        case 'remove-profiles': {
+          const id = args.id
+          if (!id) { result = { error: '--id required (list ID)' }; break }
+          const profileIds = args.profiles?.split(',')
+          if (!profileIds) { result = { error: '--profiles required (comma-separated profile IDs)' }; break }
+          result = await api('DELETE', `/lists/${id}/relationships/profiles/`, {
+            data: profileIds.map(pid => ({ type: 'profile', id: pid }))
+          })
+          break
+        }
+        default:
+          result = { error: 'Unknown lists subcommand. Use: list, get, create, delete, add-profiles, remove-profiles' }
+      }
+      break
+
+    case 'events':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args.filter) params.set('filter', args.filter)
+          if (args['page-size']) params.set('page[size]', args['page-size'])
+          const qs = params.toString()
+          result = await api('GET', `/events/${qs ? '?' + qs : ''}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/events/${id}/`)
+          break
+        }
+        case 'create': {
+          const metric = args.metric
+          const email = args.email
+          if (!metric) { result = { error: '--metric required (metric name)' }; break }
+          if (!email) { result = { error: '--email required' }; break }
+          const properties = {}
+          if (args.value) properties.value = Number(args.value)
+          if (args.property) {
+            const pairs = args.property.split(',')
+            for (const pair of pairs) {
+              const [k, v] = pair.split(':')
+              if (k && v) properties[k] = v
+            }
+          }
+          result = await api('POST', '/events/', {
+            data: {
+              type: 'event',
+              attributes: {
+                metric: { data: { type: 'metric', attributes: { name: metric } } },
+                profile: { data: { type: 'profile', attributes: { email } } },
+                properties,
+                time: new Date().toISOString(),
+              }
+            }
+          })
+          break
+        }
+        default:
+          result = { error: 'Unknown events subcommand. Use: list, get, create' }
+      }
+      break
+
+    case 'campaigns':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args.filter) params.set('filter', args.filter)
+          if (args['page-size']) params.set('page[size]', args['page-size'])
+          const qs = params.toString()
+          result = await api('GET', `/campaigns/${qs ? '?' + qs : ''}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/campaigns/${id}/`)
+          break
+        }
+        default:
+          result = { error: 'Unknown campaigns subcommand. Use: list, get' }
+      }
+      break
+
+    case 'flows':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args.filter) params.set('filter', args.filter)
+          if (args['page-size']) params.set('page[size]', args['page-size'])
+          const qs = params.toString()
+          result = await api('GET', `/flows/${qs ? '?' + qs : ''}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/flows/${id}/`)
+          break
+        }
+        case 'update': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          const attributes = {}
+          if (args.status) attributes.status = args.status
+          result = await api('PATCH', `/flows/${id}/`, {
+            data: { type: 'flow', id, attributes }
+          })
+          break
+        }
+        default:
+          result = { error: 'Unknown flows subcommand. Use: list, get, update' }
+      }
+      break
+
+    case 'metrics':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args['page-size']) params.set('page[size]', args['page-size'])
+          const qs = params.toString()
+          result = await api('GET', `/metrics/${qs ? '?' + qs : ''}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/metrics/${id}/`)
+          break
+        }
+        default:
+          result = { error: 'Unknown metrics subcommand. Use: list, get' }
+      }
+      break
+
+    case 'segments':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args['page-size']) params.set('page[size]', args['page-size'])
+          const qs = params.toString()
+          result = await api('GET', `/segments/${qs ? '?' + qs : ''}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/segments/${id}/`)
+          break
+        }
+        default:
+          result = { error: 'Unknown segments subcommand. Use: list, get' }
+      }
+      break
+
+    case 'templates':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args.filter) params.set('filter', args.filter)
+          if (args['page-size']) params.set('page[size]', args['page-size'])
+          const qs = params.toString()
+          result = await api('GET', `/templates/${qs ? '?' + qs : ''}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/templates/${id}/`)
+          break
+        }
+        default:
+          result = { error: 'Unknown templates subcommand. Use: list, get' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          profiles: 'profiles [list | get --id <id> | create --email <email> | update --id <id>]',
+          lists: 'lists [list | get --id <id> | create --name <name> | delete --id <id> | add-profiles --id <list-id> --profiles <id1,id2> | remove-profiles --id <list-id> --profiles <id1,id2>]',
+          events: 'events [list | get --id <id> | create --metric <name> --email <email>]',
+          campaigns: 'campaigns [list | get --id <id>]',
+          flows: 'flows [list | get --id <id> | update --id <id> --status <status>]',
+          metrics: 'metrics [list | get --id <id>]',
+          segments: 'segments [list | get --id <id>]',
+          templates: 'templates [list | get --id <id>]',
+          options: '--filter <filter> --page-size <n> --page-cursor <cursor>',
+        }
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})