arkaos 4.26.0 → 4.28.0

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

@@ -0,0 +1,253 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.CALENDLY_API_KEY
+const BASE_URL = 'https://api.calendly.com'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'CALENDLY_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 count = args.count ? Number(args.count) : 20
+
+  switch (cmd) {
+    case 'users':
+      switch (sub) {
+        case 'me':
+          result = await api('GET', '/users/me')
+          break
+        default:
+          result = { error: 'Unknown users subcommand. Use: me' }
+      }
+      break
+
+    case 'event-types':
+      switch (sub) {
+        case 'list': {
+          const user = args.user
+          const org = args.organization
+          if (!user && !org) { result = { error: '--user or --organization URI required' }; break }
+          const params = new URLSearchParams()
+          if (user) params.set('user', user)
+          if (org) params.set('organization', org)
+          if (args.active) params.set('active', args.active)
+          params.set('count', String(count))
+          if (args['page-token']) params.set('page_token', args['page-token'])
+          result = await api('GET', `/event_types?${params}`)
+          break
+        }
+        case 'get': {
+          const uuid = args.uuid
+          if (!uuid) { result = { error: '--uuid required' }; break }
+          result = await api('GET', `/event_types/${uuid}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown event-types subcommand. Use: list, get' }
+      }
+      break
+
+    case 'events':
+      switch (sub) {
+        case 'list': {
+          const user = args.user
+          const org = args.organization
+          if (!user && !org) { result = { error: '--user or --organization URI required' }; break }
+          const params = new URLSearchParams()
+          if (user) params.set('user', user)
+          if (org) params.set('organization', org)
+          if (args['min-start']) params.set('min_start_time', args['min-start'])
+          if (args['max-start']) params.set('max_start_time', args['max-start'])
+          if (args.status) params.set('status', args.status)
+          params.set('count', String(count))
+          if (args['page-token']) params.set('page_token', args['page-token'])
+          if (args.sort) params.set('sort', args.sort)
+          result = await api('GET', `/scheduled_events?${params}`)
+          break
+        }
+        case 'get': {
+          const uuid = args.uuid
+          if (!uuid) { result = { error: '--uuid required' }; break }
+          result = await api('GET', `/scheduled_events/${uuid}`)
+          break
+        }
+        case 'cancel': {
+          const uuid = args.uuid
+          if (!uuid) { result = { error: '--uuid required' }; break }
+          const body = {}
+          if (args.reason) body.reason = args.reason
+          result = await api('POST', `/scheduled_events/${uuid}/cancellation`, body)
+          break
+        }
+        case 'invitees': {
+          const uuid = args.uuid
+          if (!uuid) { result = { error: '--uuid required (event UUID)' }; break }
+          const params = new URLSearchParams()
+          params.set('count', String(count))
+          if (args['page-token']) params.set('page_token', args['page-token'])
+          if (args.email) params.set('email', args.email)
+          if (args.status) params.set('status', args.status)
+          result = await api('GET', `/scheduled_events/${uuid}/invitees?${params}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown events subcommand. Use: list, get, cancel, invitees' }
+      }
+      break
+
+    case 'availability':
+      switch (sub) {
+        case 'times': {
+          const eventType = args['event-type']
+          if (!eventType) { result = { error: '--event-type URI required' }; break }
+          const startTime = args['start-time']
+          const endTime = args['end-time']
+          if (!startTime || !endTime) { result = { error: '--start-time and --end-time required (ISO 8601)' }; break }
+          const params = new URLSearchParams({
+            event_type: eventType,
+            start_time: startTime,
+            end_time: endTime,
+          })
+          result = await api('GET', `/event_type_available_times?${params}`)
+          break
+        }
+        case 'busy': {
+          const user = args.user
+          if (!user) { result = { error: '--user URI required' }; break }
+          const startTime = args['start-time']
+          const endTime = args['end-time']
+          if (!startTime || !endTime) { result = { error: '--start-time and --end-time required (ISO 8601)' }; break }
+          const params = new URLSearchParams({
+            user,
+            start_time: startTime,
+            end_time: endTime,
+          })
+          result = await api('GET', `/user_busy_times?${params}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown availability subcommand. Use: times, busy' }
+      }
+      break
+
+    case 'webhooks':
+      switch (sub) {
+        case 'list': {
+          const org = args.organization
+          const scope = args.scope || 'organization'
+          if (!org) { result = { error: '--organization URI required' }; break }
+          const params = new URLSearchParams({
+            organization: org,
+            scope,
+          })
+          params.set('count', String(count))
+          if (args['page-token']) params.set('page_token', args['page-token'])
+          result = await api('GET', `/webhook_subscriptions?${params}`)
+          break
+        }
+        case 'create': {
+          const url = args.url
+          const events = args.events?.split(',')
+          const org = args.organization
+          const scope = args.scope || 'organization'
+          if (!url || !events || !org) { result = { error: '--url, --events (comma-separated), and --organization required' }; break }
+          const body = { url, events, organization: org, scope }
+          if (args.user) body.user = args.user
+          result = await api('POST', '/webhook_subscriptions', body)
+          break
+        }
+        case 'delete': {
+          const uuid = args.uuid
+          if (!uuid) { result = { error: '--uuid required' }; break }
+          result = await api('DELETE', `/webhook_subscriptions/${uuid}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown webhooks subcommand. Use: list, create, delete' }
+      }
+      break
+
+    case 'org':
+      switch (sub) {
+        case 'members': {
+          const org = args.organization
+          if (!org) { result = { error: '--organization URI required' }; break }
+          const params = new URLSearchParams({ organization: org })
+          params.set('count', String(count))
+          if (args['page-token']) params.set('page_token', args['page-token'])
+          result = await api('GET', `/organization_memberships?${params}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown org subcommand. Use: members' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          users: 'users me',
+          'event-types': 'event-types [list --user <uri> | get --uuid <id>]',
+          events: 'events [list --user <uri> | get --uuid <id> | cancel --uuid <id> | invitees --uuid <id>]',
+          availability: 'availability [times --event-type <uri> --start-time <iso> --end-time <iso> | busy --user <uri> --start-time <iso> --end-time <iso>]',
+          webhooks: 'webhooks [list --organization <uri> | create --url <url> --events <e1,e2> --organization <uri> | delete --uuid <id>]',
+          org: 'org [members --organization <uri>]',
+          options: '--count <n> --page-token <token> --status <active|canceled>',
+        }
+      }
+  }
+
+  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/clay.js

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.CLAY_API_KEY
+const BASE_URL = 'https://api.clay.com/v3'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'CLAY_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': 'Bearer ***', 'Content-Type': 'application/json' }, body: body || undefined }
+  }
+  const options = {
+    method,
+    headers: {
+      'Authorization': `Bearer ${API_KEY}`,
+      'Content-Type': 'application/json',
+    },
+  }
+  if (body) options.body = JSON.stringify(body)
+  const res = await fetch(`${BASE_URL}${path}`, options)
+  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 'tables':
+      switch (sub) {
+        case 'list': {
+          result = await api('GET', `/tables?page=${page}&per_page=${perPage}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/tables/${id}`)
+          break
+        }
+        case 'rows': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/tables/${id}/rows?page=${page}&per_page=${perPage}`)
+          break
+        }
+        case 'add-row': {
+          const id = args.id
+          const data = args.data
+          if (!id) { result = { error: '--id required' }; break }
+          if (!data) { result = { error: '--data required (JSON string)' }; break }
+          let parsed
+          try {
+            parsed = JSON.parse(data)
+          } catch {
+            result = { error: 'Invalid JSON in --data' }
+            break
+          }
+          result = await api('POST', `/tables/${id}/rows`, parsed)
+          break
+        }
+        default:
+          result = { error: 'Unknown tables subcommand. Use: list, get, rows, add-row' }
+      }
+      break
+
+    case 'people':
+      switch (sub) {
+        case 'enrich': {
+          const body = {}
+          if (args.email) body.email = args.email
+          if (args.linkedin) body.linkedin_url = args.linkedin
+          if (args['first-name']) body.first_name = args['first-name']
+          if (args['last-name']) body.last_name = args['last-name']
+          if (args['first-name'] && args['last-name'] && args.domain) body.domain = args.domain
+          if (!args.email && !args.linkedin && !(args['first-name'] && args['last-name'] && args.domain)) {
+            result = { error: '--email or --linkedin required (or --first-name + --last-name + --domain)' }
+            break
+          }
+          result = await api('POST', '/people/enrich', body)
+          break
+        }
+        default:
+          result = { error: 'Unknown people subcommand. Use: enrich' }
+      }
+      break
+
+    case 'companies':
+      switch (sub) {
+        case 'enrich': {
+          const domain = args.domain
+          if (!domain) { result = { error: '--domain required' }; break }
+          result = await api('POST', '/companies/enrich', { domain })
+          break
+        }
+        default:
+          result = { error: 'Unknown companies subcommand. Use: enrich' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          tables: {
+            list: 'tables list [--page <n>] [--per-page <n>]',
+            get: 'tables get --id <table_id>',
+            rows: 'tables rows --id <table_id> [--page <n>] [--per-page <n>]',
+            'add-row': 'tables add-row --id <table_id> --data <json>',
+          },
+          people: {
+            enrich: 'people enrich --email <email> | --linkedin <url> | --first-name <n> --last-name <n> --domain <d>',
+          },
+          companies: {
+            enrich: 'companies 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/clearbit.js

@@ -0,0 +1,163 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.CLEARBIT_API_KEY
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'CLEARBIT_API_KEY environment variable required' }))
+  process.exit(1)
+}
+
+async function api(method, baseUrl, path, body) {
+  const auth = 'Basic ' + Buffer.from(`${API_KEY}:`).toString('base64')
+  if (args['dry-run']) {
+    return { _dry_run: true, method, url: `${baseUrl}${path}`, headers: { 'Authorization': '***', 'Content-Type': 'application/json', 'Accept': 'application/json' }, body: body || undefined }
+  }
+  const res = await fetch(`${baseUrl}${path}`, {
+    method,
+    headers: {
+      'Authorization': auth,
+      '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
+
+  switch (cmd) {
+    case 'person':
+      switch (sub) {
+        case 'find': {
+          const email = args.email
+          if (!email) { result = { error: '--email required' }; break }
+          result = await api('GET', 'https://person-stream.clearbit.com', `/v2/people/find?email=${encodeURIComponent(email)}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown person subcommand. Use: find' }
+      }
+      break
+
+    case 'company':
+      switch (sub) {
+        case 'find': {
+          const domain = args.domain
+          if (!domain) { result = { error: '--domain required' }; break }
+          result = await api('GET', 'https://company-stream.clearbit.com', `/v2/companies/find?domain=${encodeURIComponent(domain)}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown company subcommand. Use: find' }
+      }
+      break
+
+    case 'combined':
+      switch (sub) {
+        case 'find': {
+          const email = args.email
+          if (!email) { result = { error: '--email required' }; break }
+          result = await api('GET', 'https://person-stream.clearbit.com', `/v2/combined/find?email=${encodeURIComponent(email)}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown combined subcommand. Use: find' }
+      }
+      break
+
+    case 'reveal':
+      switch (sub) {
+        case 'find': {
+          const ip = args.ip
+          if (!ip) { result = { error: '--ip required' }; break }
+          result = await api('GET', 'https://reveal.clearbit.com', `/v1/companies/find?ip=${encodeURIComponent(ip)}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown reveal subcommand. Use: find' }
+      }
+      break
+
+    case 'name-to-domain':
+      switch (sub) {
+        case 'find': {
+          const name = args.name
+          if (!name) { result = { error: '--name required' }; break }
+          result = await api('GET', 'https://company.clearbit.com', `/v1/domains/find?name=${encodeURIComponent(name)}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown name-to-domain subcommand. Use: find' }
+      }
+      break
+
+    case 'prospector':
+      switch (sub) {
+        case 'search': {
+          const domain = args.domain
+          if (!domain) { result = { error: '--domain required' }; break }
+          const params = new URLSearchParams({ domain })
+          if (args.role) params.set('role', args.role)
+          if (args.seniority) params.set('seniority', args.seniority)
+          if (args.title) params.set('title', args.title)
+          if (args.page) params.set('page', args.page)
+          if (args['page-size']) params.set('page_size', args['page-size'])
+          result = await api('GET', 'https://prospector.clearbit.com', `/v1/people/search?${params.toString()}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown prospector subcommand. Use: search' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          person: 'person find --email <email>',
+          company: 'company find --domain <domain>',
+          combined: 'combined find --email <email>',
+          reveal: 'reveal find --ip <ip>',
+          'name-to-domain': 'name-to-domain find --name <company_name>',
+          prospector: 'prospector search --domain <domain> [--role <role>] [--seniority <level>] [--title <title>]',
+        }
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})