@juliodevelop/services

Integrações externas unificadas: Email, WhatsApp, Cloudinary, Mercado Pago e Upstash Redis.

Instale apenas os providers que usar — todas as deps são peer deps opcionais.

Instalação

npm install @juliodevelop/services
# + instale o provider que for usar:
npm install resend            # para email com Resend
npm install @sendgrid/mail    # para email com SendGrid
npm install cloudinary        # para Cloudinary
npm install mercadopago       # para Mercado Pago
npm install @upstash/redis @upstash/ratelimit  # para Upstash

Requer .npmrc configurado com o registry @juliodevelop. Veja o README raiz.

Sub-exports

@juliodevelop/services/email       → createEmailService
@juliodevelop/services/whatsapp    → whatsapp (standalone, sem deps)
@juliodevelop/services/cloudinary  → createCloudinaryService
@juliodevelop/services/mercadopago → createMercadoPagoService
@juliodevelop/services/upstash     → createCacheService, createRateLimiter

Uso

Email

import { createEmailService } from '@juliodevelop/services/email'

const email = createEmailService({
  provider: 'resend',
  apiKey: process.env.RESEND_API_KEY!,
  from: '[email protected]',
})

await email.send({
  to: '[email protected]',
  subject: 'Bem-vindo!',
  html: '<h1>Olá!</h1>',
})

WhatsApp (standalone)

import { whatsapp } from '@juliodevelop/services/whatsapp'

const link = whatsapp.createLink({
  phone: '5592991234567',
  message: 'Olá! Tenho interesse no produto X',
})

const orderMsg = whatsapp.createOrderMessage({
  items: [{ name: 'Coxinha', qty: 5, price: 5.00 }],
  total: 25.00,
  customerName: 'João',
})

Cloudinary

import { createCloudinaryService } from '@juliodevelop/services/cloudinary'

const cloud = createCloudinaryService({
  cloudName: process.env.CLOUDINARY_CLOUD_NAME!,
  apiKey: process.env.CLOUDINARY_API_KEY!,
  apiSecret: process.env.CLOUDINARY_API_SECRET!,
})

const result = await cloud.upload(file, { folder: 'products' })
const url = cloud.getUrl('products/foto.jpg', { width: 400, format: 'webp' })

Mercado Pago

import { createMercadoPagoService } from '@juliodevelop/services/mercadopago'

const mp = createMercadoPagoService({
  accessToken: process.env.MERCADOPAGO_ACCESS_TOKEN!,
})

const checkout = await mp.createCheckout({
  items: [{ title: 'Inscrição', quantity: 1, unitPrice: 89.90 }],
  payer: { email: '[email protected]' },
  backUrls: { success: 'https://meusite.com/sucesso' },
})

Upstash (Cache + Rate Limit)

import { createCacheService, createRateLimiter } from '@juliodevelop/services/upstash'

const cache = createCacheService({
  url: process.env.UPSTASH_REDIS_URL!,
  token: process.env.UPSTASH_REDIS_TOKEN!,
})

await cache.set('user:123', data, { ttl: 3600 })
const user = await cache.get<User>('user:123')

const limiter = createRateLimiter({
  url: process.env.UPSTASH_REDIS_URL!,
  token: process.env.UPSTASH_REDIS_TOKEN!,
  limiter: { requests: 10, window: '60s' },
})

const { success, remaining } = await limiter.check('user-ip')