arkaos 4.26.0 → 4.28.0

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

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.APOLLO_API_KEY
+const BASE_URL = 'https://api.apollo.io/api/v1'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'APOLLO_API_KEY environment variable required' }))
+  process.exit(1)
+}
+
+async function api(method, path, body) {
+  const authBody = body ? { ...body, api_key: API_KEY } : { api_key: API_KEY }
+  if (args['dry-run']) {
+    return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: { 'Content-Type': 'application/json' }, body: { ...authBody, api_key: '***' } }
+  }
+  const res = await fetch(`${BASE_URL}${path}`, {
+    method,
+    headers: {
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify(authBody),
+  })
+  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 page = args.page ? Number(args.page) : 1
+  const perPage = args['per-page'] ? Number(args['per-page']) : 25
+
+  switch (cmd) {
+    case 'people':
+      switch (sub) {
+        case 'search': {
+          const body = { page, per_page: perPage }
+          if (args.titles) body.person_titles = args.titles.split(',')
+          if (args.locations) body.person_locations = args.locations.split(',')
+          if (args.seniorities) body.person_seniorities = args.seniorities.split(',')
+          if (args['employee-ranges']) body.organization_num_employees_ranges = args['employee-ranges'].split(',').map(r => r.trim())
+          if (args.keywords) body.q_keywords = args.keywords
+          result = await api('POST', '/mixed_people/search', body)
+          break
+        }
+        case 'enrich': {
+          const body = {}
+          if (args.email) body.email = args.email
+          if (args['first-name']) body.first_name = args['first-name']
+          if (args['last-name']) body.last_name = args['last-name']
+          if (args.domain) body.domain = args.domain
+          if (args.linkedin) body.linkedin_url = args.linkedin
+          if (!args.email && !args.linkedin && !(args['first-name'] && args.domain)) {
+            result = { error: '--email, --linkedin, or --first-name + --domain required' }
+            break
+          }
+          result = await api('POST', '/people/match', body)
+          break
+        }
+        case 'bulk-enrich': {
+          const emails = args.emails?.split(',')
+          if (!emails) { result = { error: '--emails required (comma-separated)' }; break }
+          const details = emails.map(email => ({ email: email.trim() }))
+          result = await api('POST', '/people/bulk_match', { details })
+          break
+        }
+        default:
+          result = { error: 'Unknown people subcommand. Use: search, enrich, bulk-enrich' }
+      }
+      break
+
+    case 'organizations':
+      switch (sub) {
+        case 'search': {
+          const body = { page, per_page: perPage }
+          if (args.locations) body.organization_locations = args.locations.split(',')
+          if (args['employee-ranges']) body.organization_num_employees_ranges = args['employee-ranges'].split(',').map(r => r.trim())
+          if (args.keywords) body.q_keywords = args.keywords
+          result = await api('POST', '/mixed_companies/search', body)
+          break
+        }
+        case 'enrich': {
+          const domain = args.domain
+          if (!domain) { result = { error: '--domain required' }; break }
+          result = await api('POST', '/organizations/enrich', { domain })
+          break
+        }
+        default:
+          result = { error: 'Unknown organizations subcommand. Use: search, enrich' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          people: {
+            search: 'people search [--titles <t1,t2>] [--locations <l1,l2>] [--seniorities <s1,s2>] [--employee-ranges <1,100>] [--keywords <kw>] [--page <n>]',
+            enrich: 'people enrich --email <email> | --first-name <name> --last-name <name> --domain <domain> | --linkedin <url>',
+            'bulk-enrich': 'people bulk-enrich --emails <e1,e2,e3>',
+          },
+          organizations: {
+            search: 'organizations search [--locations <l1,l2>] [--employee-ranges <1,100>] [--keywords <kw>] [--page <n>]',
+            enrich: 'organizations enrich --domain <domain>',
+          },
+        }
+      }
+  }
+
+  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/beehiiv.js

@@ -0,0 +1,245 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.BEEHIIV_API_KEY
+const BASE_URL = 'https://api.beehiiv.com/v2'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'BEEHIIV_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 pubId = args.publication || args.pub
+  const limit = args.limit ? Number(args.limit) : 10
+
+  switch (cmd) {
+    case 'publications':
+      switch (sub) {
+        case 'list':
+          result = await api('GET', '/publications')
+          break
+        case 'get': {
+          if (!pubId) { result = { error: '--publication required' }; break }
+          result = await api('GET', `/publications/${pubId}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown publications subcommand. Use: list, get' }
+      }
+      break
+
+    case 'subscriptions':
+      switch (sub) {
+        case 'list': {
+          if (!pubId) { result = { error: '--publication required' }; break }
+          const params = new URLSearchParams()
+          params.set('limit', String(limit))
+          if (args.email) params.set('email', args.email)
+          if (args.status) params.set('status', args.status)
+          if (args.tier) params.set('tier', args.tier)
+          if (args.cursor) params.set('cursor', args.cursor)
+          if (args.expand) params.set('expand[]', args.expand)
+          result = await api('GET', `/publications/${pubId}/subscriptions?${params.toString()}`)
+          break
+        }
+        case 'get': {
+          if (!pubId) { result = { error: '--publication required' }; break }
+          const subId = args.id
+          if (!subId) { result = { error: '--id required' }; break }
+          result = await api('GET', `/publications/${pubId}/subscriptions/${subId}`)
+          break
+        }
+        case 'create': {
+          if (!pubId) { result = { error: '--publication required' }; break }
+          const email = args.email
+          if (!email) { result = { error: '--email required' }; break }
+          const body = { email }
+          if (args['reactivate-existing']) body.reactivate_existing = true
+          if (args['send-welcome-email']) body.send_welcome_email = true
+          if (args['utm-source']) body.utm_source = args['utm-source']
+          if (args['utm-medium']) body.utm_medium = args['utm-medium']
+          if (args['utm-campaign']) body.utm_campaign = args['utm-campaign']
+          if (args.tier) body.tier = args.tier
+          if (args['referring-site']) body.referring_site = args['referring-site']
+          result = await api('POST', `/publications/${pubId}/subscriptions`, body)
+          break
+        }
+        case 'update': {
+          if (!pubId) { result = { error: '--publication required' }; break }
+          const subId = args.id
+          if (!subId) { result = { error: '--id required' }; break }
+          const body = {}
+          if (args.tier) body.tier = args.tier
+          result = await api('PUT', `/publications/${pubId}/subscriptions/${subId}`, body)
+          break
+        }
+        case 'delete': {
+          if (!pubId) { result = { error: '--publication required' }; break }
+          const subId = args.id
+          if (!subId) { result = { error: '--id required' }; break }
+          result = await api('DELETE', `/publications/${pubId}/subscriptions/${subId}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown subscriptions subcommand. Use: list, get, create, update, delete' }
+      }
+      break
+
+    case 'posts':
+      switch (sub) {
+        case 'list': {
+          if (!pubId) { result = { error: '--publication required' }; break }
+          const params = new URLSearchParams()
+          params.set('limit', String(limit))
+          if (args.status) params.set('status', args.status)
+          if (args.cursor) params.set('cursor', args.cursor)
+          result = await api('GET', `/publications/${pubId}/posts?${params.toString()}`)
+          break
+        }
+        case 'get': {
+          if (!pubId) { result = { error: '--publication required' }; break }
+          const postId = args.id
+          if (!postId) { result = { error: '--id required' }; break }
+          result = await api('GET', `/publications/${pubId}/posts/${postId}`)
+          break
+        }
+        case 'create': {
+          if (!pubId) { result = { error: '--publication required' }; break }
+          const title = args.title
+          if (!title) { result = { error: '--title required' }; break }
+          const body = { title }
+          if (args.subtitle) body.subtitle = args.subtitle
+          if (args.content) body.content = args.content
+          if (args.status) body.status = args.status
+          result = await api('POST', `/publications/${pubId}/posts`, body)
+          break
+        }
+        case 'delete': {
+          if (!pubId) { result = { error: '--publication required' }; break }
+          const postId = args.id
+          if (!postId) { result = { error: '--id required' }; break }
+          result = await api('DELETE', `/publications/${pubId}/posts/${postId}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown posts subcommand. Use: list, get, create, delete' }
+      }
+      break
+
+    case 'segments':
+      switch (sub) {
+        case 'list': {
+          if (!pubId) { result = { error: '--publication required' }; break }
+          result = await api('GET', `/publications/${pubId}/segments`)
+          break
+        }
+        case 'get': {
+          if (!pubId) { result = { error: '--publication required' }; break }
+          const segId = args.id
+          if (!segId) { result = { error: '--id required' }; break }
+          result = await api('GET', `/publications/${pubId}/segments/${segId}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown segments subcommand. Use: list, get' }
+      }
+      break
+
+    case 'automations':
+      switch (sub) {
+        case 'list': {
+          if (!pubId) { result = { error: '--publication required' }; break }
+          result = await api('GET', `/publications/${pubId}/automations`)
+          break
+        }
+        case 'get': {
+          if (!pubId) { result = { error: '--publication required' }; break }
+          const autoId = args.id
+          if (!autoId) { result = { error: '--id required' }; break }
+          result = await api('GET', `/publications/${pubId}/automations/${autoId}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown automations subcommand. Use: list, get' }
+      }
+      break
+
+    case 'referral-program':
+      switch (sub) {
+        case 'get': {
+          if (!pubId) { result = { error: '--publication required' }; break }
+          result = await api('GET', `/publications/${pubId}/referral_program`)
+          break
+        }
+        default:
+          result = { error: 'Unknown referral-program subcommand. Use: get' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          publications: 'publications [list | get --publication <id>]',
+          subscriptions: 'subscriptions [list | get --id <id> | create --email <email> | update --id <id> | delete --id <id>] --publication <id>',
+          posts: 'posts [list | get --id <id> | create --title <title> | delete --id <id>] --publication <id>',
+          segments: 'segments [list | get --id <id>] --publication <id>',
+          automations: 'automations [list | get --id <id>] --publication <id>',
+          'referral-program': 'referral-program [get] --publication <id>',
+          options: '--publication <id> --limit <n> --email <email> --status <status> --tier <tier>',
+        }
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})