arkaos 4.26.0 → 4.28.0

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

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.TOLT_API_KEY
+const BASE_URL = 'https://api.tolt.io/v1'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'TOLT_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' }, body: body || undefined }
+  }
+  const res = await fetch(`${BASE_URL}${path}`, {
+    method,
+    headers: {
+      'Authorization': `Bearer ${API_KEY}`,
+      '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':
+          result = await api('GET', '/affiliates')
+          break
+        case 'get': {
+          const id = rest[0] || args.id
+          if (!id) { result = { error: 'Affiliate ID required (positional arg or --id)' }; break }
+          result = await api('GET', `/affiliates/${id}`)
+          break
+        }
+        case 'create': {
+          const body = {}
+          if (args.email) body.email = args.email
+          if (args.name) body.name = args.name
+          result = await api('POST', '/affiliates', body)
+          break
+        }
+        case 'update': {
+          if (!args.id) { result = { error: '--id required (affiliate ID)' }; break }
+          const body = {}
+          if (args['commission-rate']) body.commission_rate = Number(args['commission-rate'])
+          if (args['payout-method']) body.payout_method = args['payout-method']
+          if (args['paypal-email']) body.paypal_email = args['paypal-email']
+          result = await api('PATCH', `/affiliates/${args.id}`, body)
+          break
+        }
+        default:
+          result = { error: 'Unknown affiliates subcommand. Use: list, get, create, 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['customer-id']) params.set('customer_id', args['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
+        }
+        default:
+          result = { error: 'Unknown commissions subcommand. Use: list' }
+      }
+      break
+
+    case 'payouts':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args['affiliate-id']) params.set('affiliate_id', args['affiliate-id'])
+          result = await api('GET', `/payouts?${params}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown payouts subcommand. Use: list' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          affiliates: 'affiliates [list|get|create|update] [id] [--email <email>] [--name <name>] [--id <id>] [--commission-rate <rate>] [--payout-method <method>] [--paypal-email <email>]',
+          referrals: 'referrals [list|get] [--affiliate-id <id>] [--customer-id <id>]',
+          commissions: 'commissions [list] [--affiliate-id <id>]',
+          payouts: 'payouts [list] [--affiliate-id <id>]',
+        }
+      }
+  }
+
+  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/trustpilot.js

@@ -0,0 +1,276 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.TRUSTPILOT_API_KEY
+const API_SECRET = process.env.TRUSTPILOT_API_SECRET
+const BUSINESS_UNIT_ID = process.env.TRUSTPILOT_BUSINESS_UNIT_ID
+const BASE_URL = 'https://api.trustpilot.com/v1'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'TRUSTPILOT_API_KEY environment variable required' }))
+  process.exit(1)
+}
+
+let accessToken = null
+
+async function getAccessToken() {
+  if (accessToken) return accessToken
+  if (!API_SECRET) return null
+  const res = await fetch(`${BASE_URL}/oauth/oauth-business-users-for-applications/accesstoken`, {
+    method: 'POST',
+    headers: {
+      'Authorization': 'Basic ' + Buffer.from(`${API_KEY}:${API_SECRET}`).toString('base64'),
+      'Content-Type': 'application/x-www-form-urlencoded',
+    },
+    body: 'grant_type=client_credentials',
+  })
+  const data = await res.json()
+  if (data.access_token) {
+    accessToken = data.access_token
+    return accessToken
+  }
+  return null
+}
+
+async function api(method, path, body, auth = 'apikey') {
+  if (args['dry-run']) {
+    const maskedHeaders = { 'Content-Type': 'application/json', 'Accept': 'application/json' }
+    if (auth === 'bearer') {
+      maskedHeaders['Authorization'] = '***'
+    } else {
+      maskedHeaders['apikey'] = '***'
+    }
+    return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: maskedHeaders, body: body || undefined }
+  }
+  const headers = {
+    'Content-Type': 'application/json',
+    'Accept': 'application/json',
+  }
+  if (auth === 'bearer') {
+    const token = await getAccessToken()
+    if (!token) {
+      return { error: 'TRUSTPILOT_API_SECRET required for private API endpoints' }
+    }
+    headers['Authorization'] = `Bearer ${token}`
+  } else {
+    headers['apikey'] = 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
+  const businessUnitId = args['business-unit'] || BUSINESS_UNIT_ID
+  const limit = args.limit ? Number(args.limit) : 20
+
+  switch (cmd) {
+    case 'business':
+      switch (sub) {
+        case 'search': {
+          const query = args.query
+          if (!query) { result = { error: '--query required' }; break }
+          result = await api('GET', `/business-units/search?query=${encodeURIComponent(query)}&limit=${limit}`)
+          break
+        }
+        case 'get': {
+          if (!businessUnitId) { result = { error: '--business-unit or TRUSTPILOT_BUSINESS_UNIT_ID required' }; break }
+          result = await api('GET', `/business-units/${businessUnitId}`)
+          break
+        }
+        case 'profile': {
+          if (!businessUnitId) { result = { error: '--business-unit or TRUSTPILOT_BUSINESS_UNIT_ID required' }; break }
+          result = await api('GET', `/business-units/${businessUnitId}/profileinfo`)
+          break
+        }
+        case 'categories': {
+          if (!businessUnitId) { result = { error: '--business-unit or TRUSTPILOT_BUSINESS_UNIT_ID required' }; break }
+          result = await api('GET', `/business-units/${businessUnitId}/categories`)
+          break
+        }
+        case 'web-links': {
+          if (!businessUnitId) { result = { error: '--business-unit or TRUSTPILOT_BUSINESS_UNIT_ID required' }; break }
+          const locale = args.locale || 'en-US'
+          result = await api('GET', `/business-units/${businessUnitId}/web-links?locale=${encodeURIComponent(locale)}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown business subcommand. Use: search, get, profile, categories, web-links' }
+      }
+      break
+
+    case 'reviews':
+      switch (sub) {
+        case 'list': {
+          if (!businessUnitId) { result = { error: '--business-unit or TRUSTPILOT_BUSINESS_UNIT_ID required' }; break }
+          const reviewParams = new URLSearchParams({ perPage: String(limit), orderBy: args['order-by'] || 'createdat.desc' })
+          if (args.stars) reviewParams.set('stars', args.stars)
+          if (args.language) reviewParams.set('language', args.language)
+          result = await api('GET', `/business-units/${businessUnitId}/reviews?${reviewParams}`)
+          break
+        }
+        case 'get': {
+          const reviewId = args.id
+          if (!reviewId) { result = { error: '--id required' }; break }
+          result = await api('GET', `/reviews/${reviewId}`)
+          break
+        }
+        case 'private': {
+          if (!businessUnitId) { result = { error: '--business-unit or TRUSTPILOT_BUSINESS_UNIT_ID required' }; break }
+          const privateParams = new URLSearchParams({ perPage: String(limit) })
+          if (args.stars) privateParams.set('stars', args.stars)
+          result = await api('GET', `/private/business-units/${businessUnitId}/reviews?${privateParams}`, null, 'bearer')
+          break
+        }
+        case 'latest':
+          result = await api('GET', `/reviews/latest?count=${limit}`)
+          break
+        case 'reply': {
+          const reviewId = args.id
+          const message = args.message
+          if (!reviewId) { result = { error: '--id required' }; break }
+          if (!message) { result = { error: '--message required' }; break }
+          result = await api('POST', `/private/reviews/${reviewId}/reply`, { message }, 'bearer')
+          break
+        }
+        case 'delete-reply': {
+          const reviewId = args.id
+          if (!reviewId) { result = { error: '--id required' }; break }
+          result = await api('DELETE', `/private/reviews/${reviewId}/reply`, null, 'bearer')
+          break
+        }
+        default:
+          result = { error: 'Unknown reviews subcommand. Use: list, get, private, latest, reply, delete-reply' }
+      }
+      break
+
+    case 'invitations':
+      switch (sub) {
+        case 'create': {
+          if (!businessUnitId) { result = { error: '--business-unit or TRUSTPILOT_BUSINESS_UNIT_ID required' }; break }
+          const email = args.email
+          const name = args.name
+          if (!email) { result = { error: '--email required' }; break }
+          if (!name) { result = { error: '--name required' }; break }
+          const templateId = args.template
+          const redirectUri = args['redirect-uri'] || 'https://trustpilot.com'
+          const payload = {
+            consumerEmail: email,
+            consumerName: name,
+            referenceNumber: args.reference || '',
+            senderEmail: args['sender-email'] || undefined,
+            replyTo: args['reply-to'] || undefined,
+            templateId: templateId || undefined,
+            redirectUri,
+          }
+          result = await api('POST', `/private/business-units/${businessUnitId}/email-invitations`, payload, 'bearer')
+          break
+        }
+        case 'link': {
+          if (!businessUnitId) { result = { error: '--business-unit or TRUSTPILOT_BUSINESS_UNIT_ID required' }; break }
+          const email = args.email
+          const name = args.name
+          if (!email) { result = { error: '--email required' }; break }
+          if (!name) { result = { error: '--name required' }; break }
+          result = await api('POST', `/private/business-units/${businessUnitId}/invitation-links`, {
+            email,
+            name,
+            referenceId: args.reference || '',
+            redirectUri: args['redirect-uri'] || 'https://trustpilot.com',
+          }, 'bearer')
+          break
+        }
+        case 'templates': {
+          if (!businessUnitId) { result = { error: '--business-unit or TRUSTPILOT_BUSINESS_UNIT_ID required' }; break }
+          result = await api('GET', `/private/business-units/${businessUnitId}/templates`, null, 'bearer')
+          break
+        }
+        default:
+          result = { error: 'Unknown invitations subcommand. Use: create, link, templates' }
+      }
+      break
+
+    case 'tags':
+      switch (sub) {
+        case 'get': {
+          const reviewId = args.id
+          if (!reviewId) { result = { error: '--id required' }; break }
+          result = await api('GET', `/private/reviews/${reviewId}/tags`, null, 'bearer')
+          break
+        }
+        case 'add': {
+          const reviewId = args.id
+          const group = args.group
+          const value = args.value
+          if (!reviewId) { result = { error: '--id required' }; break }
+          if (!group || !value) { result = { error: '--group and --value required' }; break }
+          result = await api('PUT', `/private/reviews/${reviewId}/tags`, {
+            tags: [{ group, value }],
+          }, 'bearer')
+          break
+        }
+        case 'remove': {
+          const reviewId = args.id
+          const group = args.group
+          const value = args.value
+          if (!reviewId) { result = { error: '--id required' }; break }
+          if (!group || !value) { result = { error: '--group and --value required' }; break }
+          result = await api('DELETE', `/private/reviews/${reviewId}/tags?group=${encodeURIComponent(group)}&value=${encodeURIComponent(value)}`, null, 'bearer')
+          break
+        }
+        default:
+          result = { error: 'Unknown tags subcommand. Use: get, add, remove' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          business: 'business [search --query <q> | get | profile | categories | web-links]',
+          reviews: 'reviews [list | get --id <id> | private | latest | reply --id <id> --message <msg> | delete-reply --id <id>]',
+          invitations: 'invitations [create --email <e> --name <n> | link --email <e> --name <n> | templates]',
+          tags: 'tags [get --id <id> | add --id <id> --group <g> --value <v> | remove --id <id> --group <g> --value <v>]',
+          options: '--business-unit <id> --limit <n> --stars <1-5> --language <code>',
+        }
+      }
+  }
+
+  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/typeform.js

@@ -0,0 +1,269 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.TYPEFORM_API_KEY
+const BASE_URL = 'https://api.typeform.com'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'TYPEFORM_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 pageSize = args['page-size'] ? Number(args['page-size']) : undefined
+
+  switch (cmd) {
+    case 'forms':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (pageSize) params.set('page_size', String(pageSize))
+          if (args.page) params.set('page', args.page)
+          if (args['workspace-id']) params.set('workspace_id', args['workspace-id'])
+          if (args.search) params.set('search', args.search)
+          const qs = params.toString()
+          result = await api('GET', `/forms${qs ? '?' + qs : ''}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required (form ID)' }; break }
+          result = await api('GET', `/forms/${id}`)
+          break
+        }
+        case 'create': {
+          const title = args.title
+          if (!title) { result = { error: '--title required' }; break }
+          const body = { title }
+          if (args['workspace-id']) {
+            body.workspace = { href: `${BASE_URL}/workspaces/${args['workspace-id']}` }
+          }
+          result = await api('POST', '/forms', body)
+          break
+        }
+        case 'update': {
+          const id = args.id
+          if (!id) { result = { error: '--id required (form ID)' }; break }
+          const body = {}
+          if (args.title) body.title = args.title
+          result = await api('PUT', `/forms/${id}`, body)
+          break
+        }
+        case 'delete': {
+          const id = args.id
+          if (!id) { result = { error: '--id required (form ID)' }; break }
+          result = await api('DELETE', `/forms/${id}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown forms subcommand. Use: list, get, create, update, delete' }
+      }
+      break
+
+    case 'responses':
+      switch (sub) {
+        case 'list': {
+          const id = args.id
+          if (!id) { result = { error: '--id required (form ID)' }; break }
+          const params = new URLSearchParams()
+          if (pageSize) params.set('page_size', String(pageSize))
+          if (args.since) params.set('since', args.since)
+          if (args.until) params.set('until', args.until)
+          if (args.after) params.set('after', args.after)
+          if (args.before) params.set('before', args.before)
+          if (args['response-type']) params.set('response_type', args['response-type'])
+          if (args.query) params.set('query', args.query)
+          if (args.fields) params.set('fields', args.fields)
+          if (args.sort) params.set('sort', args.sort)
+          const qs = params.toString()
+          result = await api('GET', `/forms/${id}/responses${qs ? '?' + qs : ''}`)
+          break
+        }
+        case 'delete': {
+          const id = args.id
+          if (!id) { result = { error: '--id required (form ID)' }; break }
+          const responseIds = args['response-ids']
+          if (!responseIds) { result = { error: '--response-ids required (comma-separated)' }; break }
+          result = await api('DELETE', `/forms/${id}/responses?included_response_ids=${encodeURIComponent(responseIds)}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown responses subcommand. Use: list, delete' }
+      }
+      break
+
+    case 'webhooks':
+      switch (sub) {
+        case 'list': {
+          const id = args.id
+          if (!id) { result = { error: '--id required (form ID)' }; break }
+          result = await api('GET', `/forms/${id}/webhooks`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          const tag = args.tag
+          if (!id || !tag) { result = { error: '--id (form ID) and --tag required' }; break }
+          result = await api('GET', `/forms/${id}/webhooks/${tag}`)
+          break
+        }
+        case 'create': {
+          const id = args.id
+          const tag = args.tag
+          const url = args.url
+          if (!id || !tag || !url) { result = { error: '--id (form ID), --tag, and --url required' }; break }
+          const body = { url, enabled: args.enabled !== 'false' }
+          result = await api('PUT', `/forms/${id}/webhooks/${tag}`, body)
+          break
+        }
+        case 'delete': {
+          const id = args.id
+          const tag = args.tag
+          if (!id || !tag) { result = { error: '--id (form ID) and --tag required' }; break }
+          result = await api('DELETE', `/forms/${id}/webhooks/${tag}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown webhooks subcommand. Use: list, get, create, delete' }
+      }
+      break
+
+    case 'themes':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (pageSize) params.set('page_size', String(pageSize))
+          if (args.page) params.set('page', args.page)
+          const qs = params.toString()
+          result = await api('GET', `/themes${qs ? '?' + qs : ''}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required (theme ID)' }; break }
+          result = await api('GET', `/themes/${id}`)
+          break
+        }
+        case 'create': {
+          const name = args.name
+          if (!name) { result = { error: '--name required' }; break }
+          const body = { name }
+          if (args.font) body.font = args.font
+          result = await api('POST', '/themes', body)
+          break
+        }
+        case 'delete': {
+          const id = args.id
+          if (!id) { result = { error: '--id required (theme ID)' }; break }
+          result = await api('DELETE', `/themes/${id}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown themes subcommand. Use: list, get, create, delete' }
+      }
+      break
+
+    case 'images':
+      switch (sub) {
+        case 'list':
+          result = await api('GET', '/images')
+          break
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required (image ID)' }; break }
+          result = await api('GET', `/images/${id}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown images subcommand. Use: list, get' }
+      }
+      break
+
+    case 'workspaces':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (pageSize) params.set('page_size', String(pageSize))
+          if (args.page) params.set('page', args.page)
+          if (args.search) params.set('search', args.search)
+          const qs = params.toString()
+          result = await api('GET', `/workspaces${qs ? '?' + qs : ''}`)
+          break
+        }
+        case 'get': {
+          const id = args.id
+          if (!id) { result = { error: '--id required (workspace ID)' }; break }
+          result = await api('GET', `/workspaces/${id}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown workspaces subcommand. Use: list, get' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          forms: 'forms [list | get --id <id> | create --title <title> | update --id <id> --title <title> | delete --id <id>]',
+          responses: 'responses [list --id <form_id> | delete --id <form_id> --response-ids <id1,id2>]',
+          webhooks: 'webhooks [list --id <form_id> | get --id <form_id> --tag <tag> | create --id <form_id> --tag <tag> --url <url> | delete --id <form_id> --tag <tag>]',
+          themes: 'themes [list | get --id <id> | create --name <name> | delete --id <id>]',
+          images: 'images [list | get --id <id>]',
+          workspaces: 'workspaces [list | get --id <id>]',
+          options: '--page-size <n> --page <n> --since <iso> --until <iso> --query <text>',
+        }
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})