TypeScript SDK

// OAuth: use a proxy that injects the bearer token server-side
// and call your own backend endpoints to avoid exposing the token.
// The Fly API accepts:  Authorization: Bearer <access_token>
// Set this at the gateway level when forwarding merchant requests.

import { NexusClient } from '@nexus/api-client';

const epos = new NexusClient({ apiKey: process.env.ELEVATEDPOS_API_KEY! });

// List products with pagination
const { data: products, meta } = await epos.catalog.products.list({
  isActive: true,
  limit: 20,
});
console.log(`Showing ${products.length} of ${meta.totalCount} products`);

// Search customers
const { data: customers } = await epos.customers.list({ search: 'Jane' });

// Create an order
const { data: order } = await epos.orders.create({
  locationId: 'loc_01HXXXXXXXXXX',
  customerId: customers[0].id,
  lines: [
    { productId: products[0].id, quantity: 2, unitPrice: 4.50 },
  ],
});

console.log('Order created:', order.orderNumber, order.status);

// Adjust inventory after a manual count
await epos.inventory.stock.adjust(products[0].id, {
  locationId: 'loc_01HXXXXXXXXXX',
  quantity: -3,
  reason: 'manual_count',
});

// Accrue loyalty points
await epos.loyalty.accounts.accruePoints(customers[0].id, {
  orderId: order.id,
  points: 50,
  description: 'Purchase reward',
});

const { data: webhook } = await epos.webhooks.create({
  url: 'https://yourapp.com/api/elevatedpos-webhook',
  events: ['order.completed', 'payment.captured', 'inventory.low_stock'],
  label: 'Production handler',
});

// IMPORTANT: save webhook.secret securely now — it is never shown again
// Store it in an environment variable or secrets manager, never log it

// Later: list deliveries for debugging
const { data: deliveries } = await epos.webhooks.deliveries(webhook.id);
deliveries.forEach((d) => {
  console.log(d.event, d.success, d.statusCode, `${d.durationMs}ms`);
});

import { NexusClient, NexusApiError } from '@nexus/api-client';

const epos = new NexusClient({ apiKey: process.env.ELEVATEDPOS_API_KEY! });

try {
  const { data: product } = await epos.catalog.products.get('nonexistent-id');
} catch (err) {
  if (err instanceof NexusApiError) {
    // Strongly typed properties:
    console.error(err.status);          // 404
    console.error(err.message);         // "Not Found"
    console.error(err.detail);          // "Product not found"
    console.error(err.type);            // "https://elevatedpos.com.au/errors/not-found"

    // Convenience getters:
    if (err.isNotFound)        { /* handle 404 */ }
    if (err.isValidationError) { /* handle 422 — check err.detail */ }
    if (err.isUnauthorized)    { /* re-authenticate */ }
    if (err.isForbidden)       { /* insufficient permissions */ }
    if (err.isServerError)     { /* 5xx — retry with backoff */ }
  }
}