arkaos 4.26.0 → 4.28.0

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

@@ -0,0 +1,220 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.MAILCHIMP_API_KEY
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'MAILCHIMP_API_KEY environment variable required' }))
+  process.exit(1)
+}
+
+const dc = API_KEY.split('-').pop()
+const BASE_URL = `https://${dc}.api.mailchimp.com/3.0`
+
+async function api(method, path, body) {
+  const auth = 'Basic ' + Buffer.from(`anystring:${API_KEY}`).toString('base64')
+  const headers = {
+    'Authorization': auth,
+    'Content-Type': 'application/json',
+  }
+  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 'lists':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args.count) params.set('count', args.count)
+          if (args.offset) params.set('offset', args.offset)
+          result = await api('GET', `/lists?${params}`)
+          break
+        }
+        case 'get':
+          if (!rest[0]) { result = { error: 'List ID required' }; break }
+          result = await api('GET', `/lists/${rest[0]}`)
+          break
+        default:
+          result = { error: 'Unknown lists subcommand. Use: list, get' }
+      }
+      break
+
+    case 'members':
+      switch (sub) {
+        case 'list': {
+          if (!args['list-id']) {
+            result = { error: '--list-id is required for members list' }
+            break
+          }
+          const params = new URLSearchParams()
+          if (args.count) params.set('count', args.count)
+          if (args.offset) params.set('offset', args.offset)
+          if (args.status) params.set('status', args.status)
+          result = await api('GET', `/lists/${args['list-id']}/members?${params}`)
+          break
+        }
+        case 'add': {
+          if (!rest[0]) { result = { error: 'List ID required' }; break }
+          if (!args.email) { result = { error: '--email required' }; break }
+          if (!args['list-id']) {
+            result = { error: '--list-id is required for members add' }
+            break
+          }
+          const body = {
+            email_address: args.email,
+            status: args.status || 'subscribed',
+          }
+          if (args['first-name'] || args['last-name']) {
+            body.merge_fields = {}
+            if (args['first-name']) body.merge_fields.FNAME = args['first-name']
+            if (args['last-name']) body.merge_fields.LNAME = args['last-name']
+          }
+          if (args.tags) body.tags = args.tags.split(',')
+          result = await api('POST', `/lists/${args['list-id']}/members`, body)
+          break
+        }
+        case 'update': {
+          if (!args['list-id']) {
+            result = { error: '--list-id is required for members update' }
+            break
+          }
+          const subscriberHash = rest[0]
+          const body = {}
+          if (args.status) body.status = args.status
+          if (args['first-name'] || args['last-name']) {
+            body.merge_fields = {}
+            if (args['first-name']) body.merge_fields.FNAME = args['first-name']
+            if (args['last-name']) body.merge_fields.LNAME = args['last-name']
+          }
+          if (args.tags) body.tags = args.tags.split(',')
+          result = await api('PATCH', `/lists/${args['list-id']}/members/${subscriberHash}`, body)
+          break
+        }
+        default:
+          result = { error: 'Unknown members subcommand. Use: list, add, update' }
+      }
+      break
+
+    case 'campaigns':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args.count) params.set('count', args.count)
+          if (args.offset) params.set('offset', args.offset)
+          if (args.status) params.set('status', args.status)
+          if (args.type) params.set('type', args.type)
+          result = await api('GET', `/campaigns?${params}`)
+          break
+        }
+        case 'get':
+          if (!rest[0]) { result = { error: 'Campaign ID required' }; break }
+          result = await api('GET', `/campaigns/${rest[0]}`)
+          break
+        case 'create': {
+          if (!args['list-id']) { result = { error: '--list-id required' }; break }
+          const body = {
+            type: args.type || 'regular',
+            recipients: {
+              list_id: args['list-id'],
+            },
+            settings: {},
+          }
+          if (args.subject) body.settings.subject_line = args.subject
+          if (args['from-name']) body.settings.from_name = args['from-name']
+          if (args['reply-to']) body.settings.reply_to = args['reply-to']
+          if (args.title) body.settings.title = args.title
+          result = await api('POST', '/campaigns', body)
+          break
+        }
+        case 'send':
+          if (!rest[0]) { result = { error: 'Campaign ID required' }; break }
+          result = await api('POST', `/campaigns/${rest[0]}/actions/send`)
+          break
+        default:
+          result = { error: 'Unknown campaigns subcommand. Use: list, get, create, send' }
+      }
+      break
+
+    case 'reports':
+      switch (sub) {
+        case 'get':
+          if (!rest[0]) { result = { error: 'Campaign ID required' }; break }
+          result = await api('GET', `/reports/${rest[0]}`)
+          break
+        default:
+          result = { error: 'Unknown reports subcommand. Use: get' }
+      }
+      break
+
+    case 'automations':
+      switch (sub) {
+        case 'list': {
+          const params = new URLSearchParams()
+          if (args.count) params.set('count', args.count)
+          if (args.offset) params.set('offset', args.offset)
+          result = await api('GET', `/automations?${params}`)
+          break
+        }
+        default:
+          result = { error: 'Unknown automations subcommand. Use: list' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          lists: 'lists [list|get] [id] [--count <n>] [--offset <n>]',
+          members: 'members [list|add|update] [subscriber_hash] --list-id <id> [--email <email>] [--status <status>] [--first-name <name>] [--last-name <name>] [--tags <t1,t2>]',
+          campaigns: 'campaigns [list|get|create|send] [id] [--list-id <id>] [--subject <subject>] [--from-name <name>] [--reply-to <email>]',
+          reports: 'reports get <campaign_id>',
+          automations: 'automations list [--count <n>] [--offset <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/mention-me.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.MENTIONME_API_KEY
+const BASE_URL = 'https://api.mention-me.com/api/v2'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'MENTIONME_API_KEY environment variable required' }))
+  process.exit(1)
+}
+
+async function api(method, path, body) {
+  const headers = {
+    'Authorization': `Bearer ${API_KEY}`,
+    'Content-Type': 'application/json',
+  }
+  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 'offers':
+      switch (sub) {
+        case 'create': {
+          const body = {}
+          if (args.email) body.email = args.email
+          if (args.firstname) body.firstname = args.firstname
+          if (args.lastname) body.lastname = args.lastname
+          if (args['order-number']) body.order_number = args['order-number']
+          if (args['order-total']) body.order_total = Number(args['order-total'])
+          if (args['order-currency']) body.order_currency = args['order-currency']
+          result = await api('POST', '/referrer-offer', body)
+          break
+        }
+        default:
+          result = { error: 'Unknown offers subcommand. Use: create' }
+      }
+      break
+
+    case 'referrals':
+      switch (sub) {
+        case 'get': {
+          const refId = rest[0] || args.id
+          if (!refId) { result = { error: 'Referral ID required (positional arg or --id)' }; break }
+          result = await api('GET', `/referral/${refId}`)
+          break
+        }
+        case 'list': {
+          if (!args['customer-id']) { result = { error: '--customer-id required' }; break }
+          result = await api('GET', `/referrer/${args['customer-id']}/referrals`)
+          break
+        }
+        default:
+          result = { error: 'Unknown referrals subcommand. Use: get, list' }
+      }
+      break
+
+    case 'share-links':
+      switch (sub) {
+        case 'get':
+          if (!args['customer-id']) { result = { error: '--customer-id required' }; break }
+          result = await api('GET', `/referrer/${args['customer-id']}/share-links`)
+          break
+        default:
+          result = { error: 'Unknown share-links subcommand. Use: get' }
+      }
+      break
+
+    case 'rewards':
+      switch (sub) {
+        case 'get':
+          if (!args['customer-id']) { result = { error: '--customer-id required' }; break }
+          result = await api('GET', `/referrer/${args['customer-id']}/rewards`)
+          break
+        case 'redeem': {
+          if (!args['customer-id']) { result = { error: '--customer-id required' }; break }
+          const body = {}
+          if (args['reward-id']) body.reward_id = args['reward-id']
+          if (args['order-number']) body.order_number = args['order-number']
+          result = await api('POST', `/referrer/${args['customer-id']}/rewards/redeem`, body)
+          break
+        }
+        default:
+          result = { error: 'Unknown rewards subcommand. Use: get, redeem' }
+      }
+      break
+
+    case 'referee':
+      switch (sub) {
+        case 'create': {
+          const body = {}
+          if (args.email) body.email = args.email
+          if (args.firstname) body.firstname = args.firstname
+          if (args['referrer-code']) body.referrer_code = args['referrer-code']
+          if (args['order-number']) body.order_number = args['order-number']
+          if (args['order-total']) body.order_total = Number(args['order-total'])
+          result = await api('POST', '/referee', body)
+          break
+        }
+        default:
+          result = { error: 'Unknown referee subcommand. Use: create' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          offers: 'offers [create] [--email <email>] [--firstname <name>] [--lastname <name>] [--order-number <num>] [--order-total <total>] [--order-currency <currency>]',
+          referrals: 'referrals [get|list] [id] [--customer-id <id>]',
+          'share-links': 'share-links [get] [--customer-id <id>]',
+          rewards: 'rewards [get|redeem] [--customer-id <id>] [--reward-id <id>] [--order-number <num>]',
+          referee: 'referee [create] [--email <email>] [--firstname <name>] [--referrer-code <code>] [--order-number <num>] [--order-total <total>]',
+        }
+      }
+  }
+
+  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/meta-ads.js

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+
+const TOKEN = process.env.META_ACCESS_TOKEN
+const DEFAULT_ACCOUNT_ID = process.env.META_AD_ACCOUNT_ID
+const BASE_URL = 'https://graph.facebook.com/v18.0'
+
+if (!TOKEN) {
+  console.error(JSON.stringify({ error: 'META_ACCESS_TOKEN environment variable required' }))
+  process.exit(1)
+}
+
+async function api(method, path, body) {
+  const url = `${BASE_URL}${path}`
+  const opts = {
+    method,
+    headers: { 'Authorization': `Bearer ${TOKEN}` },
+  }
+  if (body) {
+    opts.headers['Content-Type'] = 'application/json'
+    opts.body = JSON.stringify(body)
+  }
+  if (args['dry-run']) {
+    return { _dry_run: true, method, url, headers: { ...opts.headers, Authorization: '***' }, body: body || undefined }
+  }
+  const res = await fetch(url, 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._
+
+function getAccountId() {
+  return args['account-id'] || DEFAULT_ACCOUNT_ID
+}
+
+async function main() {
+  let result
+
+  switch (cmd) {
+    case 'accounts':
+      switch (sub) {
+        case 'list':
+          result = await api('GET', '/me/adaccounts?fields=id,name,account_status')
+          break
+        default:
+          result = { error: 'Unknown accounts subcommand. Use: list' }
+      }
+      break
+
+    case 'campaigns':
+      switch (sub) {
+        case 'list': {
+          const accountId = getAccountId()
+          if (!accountId) { result = { error: '--account-id required (or set META_AD_ACCOUNT_ID)' }; break }
+          result = await api('GET', `/act_${accountId}/campaigns?fields=id,name,status,objective,daily_budget`)
+          break
+        }
+        case 'insights': {
+          if (!args.id) { result = { error: '--id required' }; break }
+          const datePreset = args['date-preset'] || 'last_30d'
+          result = await api('GET', `/${args.id}/insights?fields=impressions,clicks,spend,actions,cost_per_action_type&date_preset=${datePreset}`)
+          break
+        }
+        case 'create': {
+          const accountId = getAccountId()
+          if (!accountId) { result = { error: '--account-id required (or set META_AD_ACCOUNT_ID)' }; break }
+          if (!args.name || !args.objective) { result = { error: '--name and --objective required' }; break }
+          const body = {
+            name: args.name,
+            objective: args.objective,
+            status: args.status || 'PAUSED',
+            special_ad_categories: [],
+          }
+          result = await api('POST', `/act_${accountId}/campaigns`, body)
+          break
+        }
+        case 'update': {
+          if (!args.id || !args.status) { result = { error: '--id and --status required' }; break }
+          result = await api('POST', `/${args.id}`, { status: args.status })
+          break
+        }
+        default:
+          result = { error: 'Unknown campaigns subcommand. Use: list, insights, create, update' }
+      }
+      break
+
+    case 'adsets':
+      switch (sub) {
+        case 'list': {
+          const accountId = getAccountId()
+          if (!accountId) { result = { error: '--account-id required (or set META_AD_ACCOUNT_ID)' }; break }
+          result = await api('GET', `/act_${accountId}/adsets?fields=id,name,status,targeting,daily_budget,bid_amount`)
+          break
+        }
+        default:
+          result = { error: 'Unknown adsets subcommand. Use: list' }
+      }
+      break
+
+    case 'ads':
+      switch (sub) {
+        case 'list': {
+          if (!args['adset-id']) { result = { error: '--adset-id required' }; break }
+          result = await api('GET', `/${args['adset-id']}/ads?fields=id,name,status,creative`)
+          break
+        }
+        default:
+          result = { error: 'Unknown ads subcommand. Use: list' }
+      }
+      break
+
+    case 'audiences':
+      switch (sub) {
+        case 'list': {
+          const accountId = getAccountId()
+          if (!accountId) { result = { error: '--account-id required (or set META_AD_ACCOUNT_ID)' }; break }
+          result = await api('GET', `/act_${accountId}/customaudiences?fields=id,name,approximate_count`)
+          break
+        }
+        case 'create-lookalike': {
+          const accountId = getAccountId()
+          if (!accountId) { result = { error: '--account-id required (or set META_AD_ACCOUNT_ID)' }; break }
+          if (!args['source-id'] || !args.country) { result = { error: '--source-id and --country required' }; break }
+          result = await api('POST', `/act_${accountId}/customaudiences`, {
+            name: args.name || 'Lookalike Audience',
+            subtype: 'LOOKALIKE',
+            origin_audience_id: args['source-id'],
+            lookalike_spec: JSON.stringify({ type: 'similarity', country: args.country }),
+          })
+          break
+        }
+        default:
+          result = { error: 'Unknown audiences subcommand. Use: list, create-lookalike' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          accounts: 'accounts [list]',
+          campaigns: 'campaigns [list|insights|create|update] [--account-id <id>] [--id <id>] [--date-preset last_30d] [--name <name>] [--objective <obj>] [--status <status>]',
+          adsets: 'adsets [list] [--account-id <id>]',
+          ads: 'ads [list] --adset-id <id>',
+          audiences: 'audiences [list|create-lookalike] [--account-id <id>] [--source-id <id>] [--country US]',
+        },
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})