Integration guide

# npm
npm install @ainexium/storage

# pnpm
pnpm add @ainexium/storage

# yarn
yarn add @ainexium/storage

import { NexiumStorage } from '@ainexium/storage'

const storage = new NexiumStorage({ apiKey: process.env.NEXIUM_API_KEY })

// Upload (with optional progress tracking)
const file = await storage.upload(bucketId, fileBlob, 'photo.jpg', {
  onProgress: (pct) => console.log(pct + '%'),
})
console.log(file.id, file.url)

// List & search
const { files, total } = await storage.list(bucketId, { search: 'photo', page: 1 })

// Download URL
const url = await storage.download(file.id)

// Rename
const updated = await storage.rename(file.id, 'new-name.jpg')

// Delete
await storage.delete(file.id)

// ── Direct upload (mobile / browser) ──────────────────────────────────────
// Use this flow to upload directly to R2 without routing through your server.

// Step 1 — get a presigned upload URL (call from your backend)
const { file_id, object_key, upload_url } = await storage.presign(bucketId, {
  filename: 'photo.jpg',
  mime_type: 'image/jpeg',
})

// Step 2 — PUT the file directly to R2 (no auth header needed)
await fetch(upload_url, {
  method: 'PUT',
  headers: { 'Content-Type': 'image/jpeg' },
  body: fileBlob,
})

// Step 3 — confirm the upload so NEXIUM records the file
const saved = await storage.confirm(bucketId, {
  file_id,
  object_key,
  filename: 'photo.jpg',
  mime_type: 'image/jpeg',
  size_bytes: fileBlob.size,
})
console.log(saved.url) // permanent CDN URL

import { NexiumStorage } from '@ainexium/storage'

// Express / Node.js example
app.post('/webhook', express.raw({ type: 'application/json' }), async (req, res) => {
  try {
    const payload = await NexiumStorage.verifyWebhook(
      req.body,                               // raw Buffer
      req.headers['x-nexium-signature'],      // "sha256=..."
      process.env.NEXIUM_WEBHOOK_SECRET,
    )
    const event = payload as { event: string; data: unknown }
    console.log(event.event, event.data)      // "file.created", { id, filename, ... }
    res.sendStatus(200)
  } catch {
    res.sendStatus(401)
  }
})

curl -X POST \
  -H "Authorization: Bearer nx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"filename":"photo.jpg","mime_type":"image/jpeg"}' \
  https://api.nexiumai.io/api/v1/ext/buckets/<bucket_id>/files/presign

curl -X PUT \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg \
  "<upload_url>"

curl -X POST \
  -H "Authorization: Bearer nx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"file_id":"<file_id>","object_key":"<object_key>","filename":"photo.jpg","mime_type":"image/jpeg","size_bytes":204800}' \
  https://api.nexiumai.io/api/v1/ext/buckets/<bucket_id>/files/confirm