@synode/core

Core engine for synthetic data generation in Customer Data Platforms.

Install

npm install @synode/core

Quick Start

import {
  defineAction,
  defineAdventure,
  defineJourney,
  generate,
  InMemoryAdapter,
} from '@synode/core';

const viewPage = defineAction({
  id: 'view-page',
  name: 'page_view',
  fields: { page: () => '/home', referrer: () => 'google.com' },
});

const browsing = defineAdventure({
  id: 'browse',
  name: 'Browsing',
  actions: [viewPage],
  timeSpan: { min: '1m', max: '5m' },
});

const journey = defineJourney({
  id: 'visit',
  name: 'Site Visit',
  adventures: [browsing],
});

const adapter = new InMemoryAdapter();
await generate(journey, { users: 10, adapter });
console.log(adapter.events);

Features

• Journey hierarchy: Journey -> Adventure -> Action -> Event[]
• Personas with weighted attribute distributions
• Typed datasets with InferDatasetRow
• Parallel lanes and worker thread support
• Event schema validation (strict/warn/skip)
• Diagnostic errors with typo detection
• Built-in adapters: Console, InMemory, Callback

Documentation

• Getting Started
• API Reference
• Guides
• VS Code Extension
• GitHub

License

Proprietary -- see LICENSE for details.

Copyright © 2026 Digitl Cloud GmbH