@welshman/store

A utility package providing welshman-specific svelte store functionality and utilities for managing state. While it's primarily built for use with Svelte's store system, the concepts could be valuable for developers familiar with reactive programming patterns like RxJS.

What's Included

• Basic Utilities - Enhanced stores with persistence, throttling, and getter methods
• Event-Based Stores - Specialized stores for working with nostr events and repositories
• Custom Adapters - Two-way data transformation with maintained reactivity
• Persistence Layer - Automatic localStorage synchronization
• Performance Optimizations - Throttled updates and efficient subscription management

Quick Example

import {Repository} from '@welshman/net'
import {NAMED_PEOPLE, hexTags, tagValues} from '@welshman/util'
import type {TrustedEvent} from '@welshman/util'
import {deriveItemsByKey} from '@welshman/store'

const repository = new Repository()

type PeopleList = {event: TrustedEvent; pubkeys: string[]}

// Create a reactive map of lists indexed by pubkey. `eventToItem` maps each
// event to a stored item (or `null` to skip it) — decode it however you like.
// In a full @welshman/app setup you'd use `app.use(Domain).reader(FollowList)`.
const listsByPubkey = deriveItemsByKey<PeopleList>({
  repository,
  filters: [{kinds: [NAMED_PEOPLE]}],
  eventToItem: (event: TrustedEvent) =>
    event.tags.length > 1 ? {event, pubkeys: tagValues(hexTags("p"), event.tags)} : null,
  getKey: list => list.event.pubkey,
})

Installation

npm install @welshman/store