SDK ReferenceNode.js & WebSetup

Node.js & Web SDK

Use @aerostack/sdk for server-side code: Cloudflare Workers, Node.js, and Bun. This is the full server-side SDK with access to database, cache, AI, queue, storage, and realtime broadcast.

Install

npm install @aerostack/sdk

Initialize

import { AerostackClient } from '@aerostack/sdk'
 
const client = new AerostackClient({
  projectId: process.env.PROJECT_ID,
  apiKey: process.env.API_KEY,
  baseUrl: 'https://api.aerostack.ai/v1',
})
 
const { sdk, realtime } = client

In a Cloudflare Worker, the SDK is typically initialized from env bindings:

// Using the module-style Worker
import { AerostackClient } from '@aerostack/sdk'
 
export default {
  async fetch(request, env) {
    const { sdk } = new AerostackClient({
      projectId: env.PROJECT_ID,
      apiKey: env.API_KEY,
    })
 
    // Use sdk.db, sdk.cache, etc.
  }
}

Available modules

ModuleDescription
sdk.dbSQL queries via D1
sdk.cacheKV-backed cache
sdk.storageFile upload and R2
sdk.aiLLM completions and embeddings
sdk.queueBackground job queue
sdk.searchVector similarity search
sdk.socketRealtime broadcast (server → clients)
sdk.secretsSecret retrieval
sdk.authServer-side token verification

Next steps