arkaos 4.26.0 → 4.28.0

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

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.REWARDFUL_API_KEY
+const BASE_URL = 'https://api.getrewardful.com/v1'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'REWARDFUL_API_KEY environment variable required' }))
+  process.exit(1)
+}
+
+async function api(method, path, body) {
+  const auth = 'Basic ' + Buffer.from(`${API_KEY}:`).toString('base64')
+  if (args['dry-run']) {
+    return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: { Authorization: '***', 'Content-Type': 'application/json' }, body: body || undefined }
+  }
+  const res = await fetch(`${BASE_URL}${path}`, {
+    method,
+    headers: {
+      'Authorization': auth,
+      'Content-Type': '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 'affiliates':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args.page) params.set('page', args.page)
+          result = await api('GET', `/affiliates?${params}`)
+          break
+        }
+        case 'get':
+          if (!rest[0]) { result = { error: 'Affiliate ID required' }; break }
+          result = await api('GET', `/affiliates/${rest[0]}`)
+          break
+        case 'search': {
+          const params = new URLSearchParams()
+          if (args.email) params.set('email', args.email)
+          result = await api('GET', `/affiliates?${params}`)
+          break
+        }
+        case 'update': {
+          if (!rest[0]) { result = { error: 'Affiliate ID required' }; break }
+          const body = {}
+          if (args['first-name']) body.first_name = args['first-name']
+          if (args['last-name']) body.last_name = args['last-name']
+          if (args['paypal-email']) body.paypal_email = args['paypal-email']
+          result = await api('PUT', `/affiliates/${args.id}`, body)
+          break
+        }
+        default:
+          result = { error: 'Unknown affiliates subcommand. Use: list, get, search, update' }
+      }
+      break
+
+    case 'referrals':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args['affiliate-id']) params.set('affiliate_id', args['affiliate-id'])
+          result = await api('GET', `/referrals?${params}`)
+          break
+        }
+        case 'get': {
+          const params = new URLSearchParams()
+          if (args['stripe-customer-id']) params.set('stripe_customer_id', args['stripe-customer-id'])
+          result = await api('GET', `/referrals?${params}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown referrals subcommand. Use: list, get' }
+      }
+      break
+
+    case 'commissions':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args['affiliate-id']) params.set('affiliate_id', args['affiliate-id'])
+          result = await api('GET', `/commissions?${params}`)
+          break
+        }
+        case 'get':
+          if (!rest[0]) { result = { error: 'Commission ID required' }; break }
+          result = await api('GET', `/commissions/${rest[0]}`)
+          break
+        default:
+          result = { error: 'Unknown commissions subcommand. Use: list, get' }
+      }
+      break
+
+    case 'links':
+      switch (sub) {
+        case 'create': {
+          if (!args['affiliate-id']) { result = { error: '--affiliate-id required' }; break }
+          const body = {}
+          if (args.token) body.token = args.token
+          if (args.url) body.url = args.url
+          result = await api('POST', `/affiliates/${args['affiliate-id']}/links`, body)
+          break
+        }
+        default:
+          result = { error: 'Unknown links subcommand. Use: create' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          affiliates: 'affiliates [list|get|search|update] [id] [--email <email>] [--id <id>] [--first-name <name>] [--last-name <name>] [--paypal-email <email>]',
+          referrals: 'referrals [list|get] [--affiliate-id <id>] [--stripe-customer-id <id>]',
+          commissions: 'commissions [list|get] [id] [--affiliate-id <id>]',
+          links: 'links [create] [--affiliate-id <id>] [--token <token>] [--url <url>]',
+        }
+      }
+  }
+
+  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/savvycal.js

@@ -0,0 +1,223 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.SAVVYCAL_API_KEY
+const BASE_URL = 'https://api.savvycal.com/v1'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'SAVVYCAL_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 limit = args.limit ? Number(args.limit) : 20
+
+  switch (cmd) {
+    case 'me':
+      result = await api('GET', '/me')
+      break
+
+    case 'links':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          params.set('limit', String(limit))
+          if (args.after) params.set('after', args.after)
+          if (args.before) params.set('before', args.before)
+          result = await api('GET', `/scheduling-links?${params}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/scheduling-links/${id}`)
+          break
+        }
+        case 'create': {
+          const name = args.name
+          if (!name) { result = { error: '--name required' }; break }
+          const body = { name }
+          if (args.slug) body.slug = args.slug
+          if (args.duration) body.duration_minutes = Number(args.duration)
+          result = await api('POST', '/scheduling-links', body)
+          break
+        }
+        case 'update': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          const body = {}
+          if (args.name) body.name = args.name
+          if (args.slug) body.slug = args.slug
+          if (args.duration) body.duration_minutes = Number(args.duration)
+          result = await api('PATCH', `/scheduling-links/${id}`, body)
+          break
+        }
+        case 'delete': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('DELETE', `/scheduling-links/${id}`)
+          break
+        }
+        case 'duplicate': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('POST', `/scheduling-links/${id}/duplicate`)
+          break
+        }
+        case 'toggle': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('POST', `/scheduling-links/${id}/toggle`)
+          break
+        }
+        case 'slots': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          const params = new URLSearchParams()
+          if (args['start-time']) params.set('start_time', args['start-time'])
+          if (args['end-time']) params.set('end_time', args['end-time'])
+          const qs = params.toString()
+          result = await api('GET', `/scheduling-links/${id}/slots${qs ? '?' + qs : ''}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown links subcommand. Use: list, get, create, update, delete, duplicate, toggle, slots' }
+      }
+      break
+
+    case 'events':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          params.set('limit', String(limit))
+          if (args.after) params.set('after', args.after)
+          if (args.before) params.set('before', args.before)
+          result = await api('GET', `/events?${params}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('GET', `/events/${id}`)
+          break
+        }
+        case 'create': {
+          const linkId = args['link-id']
+          const startAt = args['start-at']
+          const name = args.name
+          const email = args.email
+          if (!linkId || !startAt || !name || !email) {
+            result = { error: '--link-id, --start-at, --name, and --email required' }
+            break
+          }
+          result = await api('POST', '/events', {
+            scheduling_link_id: linkId,
+            start_at: startAt,
+            name,
+            email,
+          })
+          break
+        }
+        case 'cancel': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('POST', `/events/${id}/cancel`)
+          break
+        }
+        default:
+          result = { error: 'Unknown events subcommand. Use: list, get, create, cancel' }
+      }
+      break
+
+    case 'webhooks':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          params.set('limit', String(limit))
+          if (args.after) params.set('after', args.after)
+          if (args.before) params.set('before', args.before)
+          result = await api('GET', `/webhooks?${params}`)
+          break
+        }
+        case 'create': {
+          const url = args.url
+          const events = args.events?.split(',')
+          if (!url || !events) { result = { error: '--url and --events (comma-separated) required' }; break }
+          result = await api('POST', '/webhooks', { url, events })
+          break
+        }
+        case 'delete': {
+          const id = args.id
+          if (!id) { result = { error: '--id required' }; break }
+          result = await api('DELETE', `/webhooks/${id}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown webhooks subcommand. Use: list, create, delete' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          me: 'me',
+          links: 'links [list | get --id <id> | create --name <name> | update --id <id> | delete --id <id> | duplicate --id <id> | toggle --id <id> | slots --id <id>]',
+          events: 'events [list | get --id <id> | create --link-id <id> --start-at <iso> --name <name> --email <email> | cancel --id <id>]',
+          webhooks: 'webhooks [list | create --url <url> --events <e1,e2> | delete --id <id>]',
+          options: '--limit <n> --after <cursor> --before <cursor>',
+        }
+      }
+  }
+
+  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/segment.js

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+
+const WRITE_KEY = process.env.SEGMENT_WRITE_KEY
+const ACCESS_TOKEN = process.env.SEGMENT_ACCESS_TOKEN
+const TRACKING_URL = 'https://api.segment.io/v1'
+const PROFILE_URL = 'https://profiles.segment.com/v1'
+
+if (!WRITE_KEY && !ACCESS_TOKEN) {
+  console.error(JSON.stringify({ error: 'SEGMENT_WRITE_KEY (for tracking) or SEGMENT_ACCESS_TOKEN (for profiles) environment variable required' }))
+  process.exit(1)
+}
+
+async function trackApi(method, path, body) {
+  if (!WRITE_KEY) {
+    return { error: 'SEGMENT_WRITE_KEY required for tracking operations' }
+  }
+  if (args['dry-run']) {
+    return { _dry_run: true, method, url: `${TRACKING_URL}${path}`, headers: { Authorization: '***', 'Content-Type': 'application/json' }, body: body || undefined }
+  }
+  const auth = Buffer.from(`${WRITE_KEY}:`).toString('base64')
+  const res = await fetch(`${TRACKING_URL}${path}`, {
+    method,
+    headers: {
+      'Authorization': `Basic ${auth}`,
+      'Content-Type': '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 }
+  }
+}
+
+async function profileApi(method, path) {
+  if (!ACCESS_TOKEN) {
+    return { error: 'SEGMENT_ACCESS_TOKEN required for profile operations' }
+  }
+  if (args['dry-run']) {
+    return { _dry_run: true, method, url: `${PROFILE_URL}${path}`, headers: { Authorization: '***', 'Content-Type': 'application/json' } }
+  }
+  const auth = Buffer.from(`${ACCESS_TOKEN}:`).toString('base64')
+  const res = await fetch(`${PROFILE_URL}${path}`, {
+    method,
+    headers: {
+      'Authorization': `Basic ${auth}`,
+      'Content-Type': 'application/json',
+    },
+  })
+  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 'track':
+      switch (sub) {
+        case 'event': {
+          if (!args['user-id']) { result = { error: '--user-id required' }; break }
+          if (!args.event) { result = { error: '--event required' }; break }
+          const body = {
+            userId: args['user-id'],
+            event: args.event,
+          }
+          if (args.properties) {
+            try { body.properties = JSON.parse(args.properties) } catch { result = { error: 'Invalid JSON in --properties' }; break }
+          }
+          result = await trackApi('POST', '/track', body)
+          break
+        }
+        default:
+          result = { error: 'Unknown track subcommand. Use: event' }
+      }
+      break
+
+    case 'identify':
+      switch (sub) {
+        case 'user': {
+          if (!args['user-id']) { result = { error: '--user-id required' }; break }
+          const body = { userId: args['user-id'] }
+          if (args.traits) {
+            try { body.traits = JSON.parse(args.traits) } catch { result = { error: 'Invalid JSON in --traits' }; break }
+          }
+          result = await trackApi('POST', '/identify', body)
+          break
+        }
+        default:
+          result = { error: 'Unknown identify subcommand. Use: user' }
+      }
+      break
+
+    case 'page':
+      switch (sub) {
+        case 'view': {
+          if (!args['user-id']) { result = { error: '--user-id required' }; break }
+          const body = { userId: args['user-id'] }
+          if (args.name) body.name = args.name
+          if (args.properties) {
+            try { body.properties = JSON.parse(args.properties) } catch { result = { error: 'Invalid JSON in --properties' }; break }
+          }
+          result = await trackApi('POST', '/page', body)
+          break
+        }
+        default:
+          result = { error: 'Unknown page subcommand. Use: view' }
+      }
+      break
+
+    case 'batch':
+      switch (sub) {
+        case 'send': {
+          if (!args.events) { result = { error: '--events required (JSON array)' }; break }
+          let batch
+          try { batch = JSON.parse(args.events) } catch { result = { error: 'Invalid JSON in --events' }; break }
+          result = await trackApi('POST', '/batch', { batch })
+          break
+        }
+        default:
+          result = { error: 'Unknown batch subcommand. Use: send' }
+      }
+      break
+
+    case 'profiles':
+      switch (sub) {
+        case 'traits': {
+          if (!args['space-id']) { result = { error: '--space-id required' }; break }
+          if (!args['user-id']) { result = { error: '--user-id required' }; break }
+          result = await profileApi('GET', `/spaces/${args['space-id']}/collections/users/profiles/user_id:${args['user-id']}/traits`)
+          break
+        }
+        case 'events': {
+          if (!args['space-id']) { result = { error: '--space-id required' }; break }
+          if (!args['user-id']) { result = { error: '--user-id required' }; break }
+          result = await profileApi('GET', `/spaces/${args['space-id']}/collections/users/profiles/user_id:${args['user-id']}/events`)
+          break
+        }
+        default:
+          result = { error: 'Unknown profiles subcommand. Use: traits, events' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          track: 'track event --user-id <id> --event <name> [--properties <json>]',
+          identify: 'identify user --user-id <id> [--traits <json>]',
+          page: 'page view --user-id <id> [--name <name>] [--properties <json>]',
+          batch: 'batch send --events <json_array>',
+          profiles: 'profiles [traits|events] --space-id <id> --user-id <id>',
+        }
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})