@loop/bigcommerce

pnpm add @loop/bigcommerce

import { BigCommerceClient } from '@loop/bigcommerce'
 
const bc = new BigCommerceClient({
  storeHash: process.env.BC_STORE_HASH!,
  accessToken: process.env.BC_ACCESS_TOKEN!
})
 
// Fetch an order
const order = await bc.orders.get(12345)
 
// Get customer details
const customer = await bc.customers.get(67890)
 
// Create a cart
const cart = await bc.carts.create({
  lineItems: [
    { productId: 123, quantity: 2 }
  ]
})

import { BigCommerceClient } from '@loop/bigcommerce'
 
const bc = new BigCommerceClient({
  storeHash: 'abc123xyz',      // Your store hash
  accessToken: 'your_token',   // API access token
  apiVersion: 'v3'             // Optional, defaults to 'v3'
})

// Get order
const order = await bc.orders.get(orderId)
 
// List orders
const orders = await bc.orders.list({
  minId: 1000,
  status: 'awaiting_fulfillment'
})
 
// Update order status
await bc.orders.update(orderId, {
  status: 'shipped'
})

// Get customer
const customer = await bc.customers.get(customerId)
 
// Create customer
const newCustomer = await bc.customers.create({
  email: 'user@example.com',
  firstName: 'John',
  lastName: 'Doe'
})
 
// List customers
const customers = await bc.customers.list({
  email: 'user@example.com'
})

// Get product by ID
const product = await bc.products.get(productId)
 
// List products
const products = await bc.products.list({
  categories: [23],
  isVisible: true
})
 
// Get product by SKU
const product = await bc.products.getBySku('BPC-157-5MG')

// Create cart
const cart = await bc.carts.create({
  lineItems: [
    { productId: 123, quantity: 1, variantId: 456 }
  ],
  customerId: 789
})
 
// Add item to cart
await bc.carts.addItem(cartId, {
  productId: 123,
  quantity: 2
})
 
// Get redirect URL
const redirectUrl = await bc.carts.getRedirectUrl(cartId)

import { verifyWebhookSignature } from '@loop/bigcommerce/webhooks'
 
export async function POST(req: Request) {
  const body = await req.text()
  const signature = req.headers.get('x-bc-webhook-signature')
 
  const isValid = verifyWebhookSignature({
    body,
    signature: signature!,
    secret: process.env.BC_WEBHOOK_SECRET!
  })
 
  if (!isValid) {
    return new Response('Invalid signature', { status: 401 })
  }
 
  // Process webhook...
}

import { dispatchWebhook } from '@loop/bigcommerce/webhooks'
 
const payload = JSON.parse(body)
 
await dispatchWebhook(payload, {
  'store/order/created': async (data) => {
    console.log('New order:', data.orderId)
    // Sync to database, send notifications, etc.
  },
  'store/cart/updated': async (data) => {
    console.log('Cart updated:', data.cartId)
  },
  'store/order/refund/created': async (data) => {
    console.log('Refund created:', data.refundId)
  }
})

import { getProductId, getProductSlug } from '@loop/bigcommerce/product-map'
 
// Slug → BigCommerce ID
const bcId = getProductId('bpc-157-5mg')  // Returns: 123
 
// BigCommerce ID → Slug
const slug = getProductSlug(123)  // Returns: 'bpc-157-5mg'

import { buildAffiliateCartUrl } from '@loop/bigcommerce'
 
const url = buildAffiliateCartUrl({
  products: [
    { slug: 'bpc-157-5mg', quantity: 2 },
    { slug: 'tb-500-5mg', quantity: 1 }
  ],
  affiliateCode: 'PARTNER10',
  storeUrl: 'https://loopbiolabs.com'
})
 
// Returns: https://loopbiolabs.com/cart.php?action=add&product_id=123&qty=2&product_id=456&qty=1&coupon=PARTNER10

# BigCommerce API
BC_STORE_HASH=abc123xyz
BC_ACCESS_TOKEN=your_token_here
 
# Webhooks
BC_WEBHOOK_SECRET=your_webhook_secret

import { getProductId } from '@loop/bigcommerce/product-map'
 
const result = getProductId('bpc-157-5mg')
 
if (result.ok) {
  console.log('Product ID:', result.data)
} else {
  console.error('Error:', result.error.message)
}

# Run tests
pnpm --filter @loop/bigcommerce test
 
# Run specific test
pnpm --filter @loop/bigcommerce test product-map

// Old (loopbio-v2)
import { bcClient } from '@/lib/integrations/bigcommerce'
 
// New (@loop/bigcommerce)
import { BigCommerceClient } from '@loop/bigcommerce'
const bc = new BigCommerceClient({ ... })