Package Exports

@rushdb/javascript-sdk
@rushdb/javascript-sdk/dist/index.cjs
@rushdb/javascript-sdk/dist/index.mjs

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@rushdb/javascript-sdk) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

RushDB — JavaScript & TypeScript SDK

The memory layer for AI agents and apps.

Push any JSON. Get graph relationships and vector search — automatically. No schema. No pipeline. No glue code.

🌐 Website • 📖 Documentation • ☁️ Cloud • 🔍 Examples

Why RushDB

Agents need memory. Apps need connected data. The standard answer involves multiple databases, schema design, and an embedding pipeline before you write a single useful line of business logic.

RushDB skips all of that:

Managed embeddings — mark a property for indexing once; every write is auto-embedded server-side
Graph auto-structured — nested JSON becomes a traversable graph; no manual edge creation
Semantic + graph in one query — filter by relationships, rank by meaning, compute metrics — one call (use select/groupBy)
Zero schema — push any shape; RushDB infers types and links records
6.9KB gzipped — zero runtime dependencies
Isomorphic — Node.js and browser

Installation

npm install @rushdb/javascript-sdk
# yarn add @rushdb/javascript-sdk
# pnpm add @rushdb/javascript-sdk

Agent memory in 3 lines

Get an API key at app.rushdb.com.

import RushDB from '@rushdb/javascript-sdk'

const db = new RushDB('RUSHDB_API_KEY')

// 1. One-time: index a property for semantic search
await db.ai.indexes.create({ label: 'MEMORY', propertyName: 'output' })

// 2. Store — no embedder needed, server handles it
await db.records.create({
  label: 'MEMORY',
  data: {
    agent_id: 'agent-42',
    session_id: 'sess-001',
    action: 'summarized',
    topic: 'Q4 results',
    output: summaryText,
  },
})

// 3. Recall by meaning, scoped by graph
const memories = await db.ai.search({
  labels: ['MEMORY'],
  propertyName: 'output',
  query: 'what did we decide about Q4?',
  where: { agent_id: 'agent-42' },
  limit: 10,
})

Graph traversal

// Push nested JSON — relationships created automatically
await db.records.importJson({
  label: 'COMPANY',
  payload: {
    name: 'Acme Corp',
    DEPARTMENT: [{
      name: 'Engineering',
      EMPLOYEE: [{
        name: 'Alice',
        role: 'Staff Engineer',
      }]
    }]
  }
})

// Traverse the auto-created graph
const engineers = await db.records.find({
  labels: ['EMPLOYEE'],
  where: {
    role: { $contains: 'Engineer' },
    DEPARTMENT: { COMPANY: { name: 'Acme Corp' } },
  },
})

// Constrain by relationship type and direction
const authoredPosts = await db.records.find({
  labels: ['USER'],
  where: {
    POST: {
      $relation: { type: 'AUTHORED', direction: 'out' },
      title: { $contains: 'graph' },
    },
  },
  limit: 10,
})

// Manage relationships explicitly
const company = await db.records.findUniq({
  labels: ['COMPANY'],
  where: { name: 'Acme Corp' },
})
await company.attach(engineers, { type: 'EMPLOYS' })

Unified query API

One JSON structure works for records, labels, properties, relationships, aggregations, and vector search:

const result = await db.records.find({
  labels: ['TRANSACTION'],
  where: {
    status: 'posted',
    amount: { $gte: 100 },
  },
  select: {
    total: { $sum: '$record.amount' },
  },
  groupBy: ['$record.category'],
  // Legacy: The aggregate clause is deprecated and should only be used for vector similarity until select supports it.
  orderBy: { amount: 'desc' },
  limit: 50,
})

The same shape works with db.labels.find(), db.properties.find(), and db.relationships.find() — learn once, works everywhere.

SDK configuration

import RushDB from '@rushdb/javascript-sdk'

const db = new RushDB('RUSHDB_API_KEY', {
  // Override for self-hosted or staging
  url: 'http://your-rushdb-server.com/api/v1',
  timeout: 30000,
})

Key options:

url — full API URL (default: https://api.rushdb.com/api/v1)
host, port, protocol — alternative to url
timeout — request timeout in ms (default: 10000)
httpClient — custom HTTP client for advanced use
options.allowForceDelete — allow deleting all records without criteria (default: false)

Full config reference: docs.rushdb.com/typescript-sdk/introduction#sdk-configuration-options

Documentation

docs.rushdb.com/typescript-sdk — full API reference, examples, transactions, CSV import, and more.

Contributing

See CONTRIBUTING.md. Issues and PRs welcome.