Define a Schema with table()

import { table } from '@vielzeug/deposit';

type User = { id: number; name: string };
type Post = { id: number; title: string; userId: number };

const schema = {
  users: table<User>('id'),
  posts: table<Post>('id'),
};

No Schema<{...}> annotation needed. typeof schema carries full type information.

LocalStorage

import { createLocalStorage, table } from '@vielzeug/deposit';

type User = { id: number; name: string };
const schema = { users: table<User>('id') };

const db = createLocalStorage('demo', schema);
await db.put('users', { id: 1, name: 'Alice' });
console.log(await db.getAll('users'));

LocalStorage with TTL

import { createLocalStorage, table, ttl } from '@vielzeug/deposit';

type Session = { id: string; userId: number };
const schema = { sessions: table<Session>('id') };

const db = createLocalStorage('demo-ttl', schema);
await db.put('sessions', { id: 's1', userId: 1 }, ttl.minutes(30));

SessionStorage

import { createSessionStorage, table } from '@vielzeug/deposit';

type Draft = { id: string; body: string };
const schema = { drafts: table<Draft>('id') };

const db = createSessionStorage('editor', schema);
await db.put('drafts', { id: 'd1', body: 'hello' });
console.log(await db.get('drafts', 'd1'));

IndexedDB

import { createIndexedDB, table } from '@vielzeug/deposit';

type Product = { id: number; name: string; price: number };
const schema = { products: table<Product>('id') };

const db = createIndexedDB({ dbName: 'catalog', schemaVersion: 1, schema });
await db.put('products', { id: 1, name: 'Keyboard', price: 99 });
const pricey = await db.query('products').between('price', 50, 200).toArray();
console.log(pricey);

Memory Adapter

import { createMemory, table } from '@vielzeug/deposit';

type User = { id: number; name: string };
const schema = { users: table<User>('id') };

const db = createMemory(schema);
await db.put('users', { id: 1, name: 'Alice' });
console.log(await db.getAll('users'));

No browser APIs required — ideal for tests and server environments.

Existence Check and Bulk Write

await db.putAll('users', [
  { id: 1, name: 'Alice' },
  { id: 2, name: 'Bob' },
]);

console.log(await db.has('users', 1)); // true
console.log(await db.has('users', 99)); // false

Query Composition

const page = await db
  .query('products')
  .startsWith('name', 'k', { ignoreCase: true })
  .orderBy('price', 'asc')
  .limit(10)
  .offset(0)
  .toArray();

const total = await db.query('products').count();

// Get the single cheapest matching product
const cheapest = await db
  .query('products')
  .startsWith('name', 'k', { ignoreCase: true })
  .orderBy('price', 'asc')
  .first();