Configuration

Configure Sairin for your app.

Basic Setup

import { configureSairin } from 'sairin';

configureSairin({
  lockViolation: "warn",
});

Options

Lock Violation Behavior

"throw" (development)

Throws an error with full stack trace:

configureSairin({ lockViolation: "throw" });

lock(path("app", "currentUser"), { owner: "auth" });
signal(path("app", "currentUser")).set("bob");  // Throws!

"warn" (production)

Logs a warning via Satori and continues:

configureSairin({ lockViolation: "warn" });
// Logs: "Lock violation: cannot write to /app/currentUser, owned by auth"

"silent"

Silently drops the write:

configureSairin({ lockViolation: "silent" });
// No output, write is ignored

Satori Integration

Connect Satori for structured logging:

import { createSatori } from '@nisoku/satori-log';
import { configureSairin } from 'sairin';

const satori = createSatori({
  logLevel: 'info',
});

configureSairin({
  satori,
});

All Sairin errors route through Satori with tags: