@x12i/xtivix-conformance

Conformance test suite for xtivix adapters: schema validity, purity, unknown-field preservation and golden files.

Part of xtivix, which collects provider-side AI logs, normalizes them to one canonical record, stores them in MongoDB and forwards them to observability tools.

Install

npm install @x12i/xtivix-conformance

Requires vitest >=3 as a peer dependency.

Usage

// my-adapter.test.ts, run with vitest
import path from 'node:path';
import { fileURLToPath } from 'node:url';
import { defineAdapterConformance } from '@x12i/xtivix-conformance';
import { myAdapter } from './index.js';

defineAdapterConformance(myAdapter, {
  fixturesDir: path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'fixtures'),
  source: { id: 'src_custom', provider: 'custom', store_content: true },
});

ESM only, Node.js 22 or newer. Type declarations are included.