transactology.dev

What is Transactology?

Transactology is a developer toolkit for building, inspecting, and verifying digital transaction pipelines. Every transaction is a discrete unit — countable, exact, immutable. We provide the precision instruments to work with them.

Built for engineers who treat transactions as first-class citizens in their architecture. No abstractions that leak. No magic that hides.

Core API

Initialize the transaction context and begin building pipelines with type-safe, composable primitives.

import { TxContext, Pipeline } from 'transactology';

const ctx = new TxContext({
  isolation: 'serializable',
  timeout: 5000,
  retries: 3
});

const pipeline = Pipeline.create(ctx)
  .step('validate', validateInput)
  .step('transform', normalizePayload)
  .step('commit', persistTransaction)
  .onError(rollbackHandler);

Transaction Inspection

Inspect any transaction at any stage. The inspector provides full visibility into the transaction lifecycle — from creation to commit or rollback.

const inspector = ctx.inspect(txId);

// Full transaction trace
inspector.trace().forEach(event => {
  console.log(
    `[${event.stage}]`,
    event.timestamp,
    event.delta
  );
});

// Verify integrity
const valid = inspector.verify({
  checksum: true,
  ordering: true,
  idempotency: true
});

Get Started

Install via your preferred package manager:

# npm
npm install transactology

# yarn
yarn add transactology

# pnpm
pnpm add transactology

Requires Node.js 18+ and TypeScript 5.0+. Zero runtime dependencies.