Arsenal 2.0 Migration

Use category entry points

Package root now exposes common utilities only. Import specialized APIs from category entry points.

// Before
import { debounce, hash, retry } from '@vielzeug/arsenal';

// After
import { debounce } from '@vielzeug/arsenal/function';
import { hash } from '@vielzeug/arsenal/object';
import { retry } from '@vielzeug/arsenal/async';

Replace parseJSON

parseJSON no longer accepts fallback, validator, or generic type arguments.

// Before
const user = parseJSON<User>(raw, { fallback, validator });

// After
const parsed = tryParseJson(raw);
if (!parsed.ok) return fallback;
const user = UserSchema.parse(parsed.value);

Replace stash

stash is replaced by identity-keyed cache.

// Before
const users = stash<User>({ ttlMs: 60_000 });
const user = await users.getOrSet('user:1', () => loadUser(1));

// After
const users = cache<string, User>({ ttlMs: 60_000 });
const user = await users.getOrLoad('user:1', () => loadUser(1));

cache has no hash, forceRefresh, onEvict, entries, or eager timer cleanup. Delete a key before reloading it. Use Vault for persistent storage.

Replace queue

queue is replaced by taskPool.

// Before
const q = queue({ concurrency: 2 });
const result = await q.add(() => loadUser());
await q.onIdle();

// After
const pool = taskPool({ concurrency: 2 });
const result = await pool.run((signal) => loadUser(signal));
await pool.idle();
pool.dispose();

taskPool has no priorities or settled-result subscriptions. Await returned task promises.

Make fuzzy fields explicit

// Before
fuzzyFilter(users, query, { fields: ['name', 'email'] });

// After
fuzzyFilter(users, query, { select: (user) => [user.name, user.email] });

Object collections always require select. String arrays do not.