JAZMIN (Javascript Secure Zipped Multi Index Notation) is a file format for lists of records: the data you would normally keep in a JSON array, a CSV file or a database export. A JAZMIN file (.jzm) is:

• Small: compressed column by column, with names stored once. About 24× smaller than JSON and 61% smaller than gzipped JSON on the benchmark data.
• Fast to search: built-in indexes and per-chunk statistics find matching records without loading the file. One record out of 200,000: 1.4 ms in .NET, against 265 ms with Newtonsoft.Json.
• Encrypted when you want it: AES-256 under one key or password, every part authenticated.
• Shareable in parts: one file, many keys, each opening only its own rows and columns, with optional expiry.
• Convertible: to and from JSON, CSV and XML in one call, including nested JSON and XML shapes.

The same files are read and written by JavaScript/TypeScript (Node.js 22+, and browsers) and .NET 10.

import { JazminKey, open, write } from '@smithsoft-studios/jazmin';

const customers = [
  { id: 1, name: 'Ann', country: 'ZA', balance: 1520.75 },
  { id: 2, name: 'Bob', country: 'NA', balance: 99.1 },
  { id: 3, name: 'Thabo', country: 'ZA', balance: 310 },
];
const key = JazminKey.generate(); // keep key.export() in a secret manager
write('customers.jzm', customers, { indexes: { country: 'sorted' }, key });

const reader = open('customers.jzm', { key: key.export() });
for (const row of reader.find({ country: 'ZA', balance: { gt: 100 } })) console.log(row.name);

Ann
Thabo

var settings = new JazminSerializerSettings { Key = key };
new JazminSerializer(settings).Serialize("customers.jzm", customers);

using var reader = JazminReader.Open("customers.jzm", new JazminReadOptions { Key = key });
foreach (var c in reader.Query<Customer>(c => c.Country == "ZA" && c.Balance > 100m)) Console.WriteLine(c.Name);

Recipes · Errors and Troubleshooting · FAQ · Versions and Compatibility · Security Model · Format Overview · Glossary

Every runnable example in this wiki is checked against the libraries with tools/check-examples.mjs: the output shown under an example is what it prints.