@atcute/cache 0.1.0

package/LICENSE

@@ -0,0 +1,14 @@
+BSD Zero Clause License
+
+Copyright (c) 2025 Mary
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# @atcute/cache
+
+> [!WARNING]
+> experimental package - API may change
+
+normalized cache store for AT Protocol.
+
+```sh
+npm install @atcute/cache
+```
+
+stores entities by their unique keys and automatically deduplicates nested references. when an
+entity appears in multiple API responses (e.g., a profile in a post author and in followers), they
+share the same object reference in memory.
+
+## usage
+
+### setting up the cache
+
+```ts
+import { NormalizedCache } from '@atcute/cache';
+import { AppBskyActorDefs, AppBskyFeedDefs } from '@atcute/bluesky';
+
+const cache = new NormalizedCache();
+
+// register entity types with key extractors
+cache.define({
+	schema: AppBskyFeedDefs.postViewSchema,
+	key: (post) => post.uri,
+});
+
+cache.define({
+	schema: AppBskyActorDefs.profileViewBasicSchema,
+	key: (profile) => profile.did,
+});
+```
+
+### normalizing API responses
+
+```ts
+import { AppBskyFeedGetTimeline } from '@atcute/bluesky';
+
+const response = await rpc.get('app.bsky.feed.getTimeline', { params: {} });
+
+// walks the response, extracts entities, and stores them
+const timeline = cache.normalize(AppBskyFeedGetTimeline.mainSchema.output.schema, response.data);
+```
+
+### reading from cache
+
+```ts
+const post = cache.get(AppBskyFeedDefs.postViewSchema, 'at://did:plc:.../app.bsky.feed.post/...');
+const profile = cache.get(AppBskyActorDefs.profileViewBasicSchema, 'did:plc:...');
+
+// check if entity exists
+if (cache.has(AppBskyFeedDefs.postViewSchema, postUri)) {
+	// ...
+}
+
+// get all cached entities of a type
+const allPosts = cache.getAll(AppBskyFeedDefs.postViewSchema);
+```
+
+### optimistic updates
+
+```ts
+// update a post's like count immediately, before the API responds
+cache.update(AppBskyFeedDefs.postViewSchema, postUri, (post) => ({
+	...post,
+	viewer: { ...post.viewer, like: tempLikeUri },
+	likeCount: (post.likeCount ?? 0) + 1,
+}));
+```
+
+### subscribing to changes
+
+```ts
+// subscribe to a specific entity
+const unsubscribe = cache.subscribe(AppBskyFeedDefs.postViewSchema, postUri, (post) => {
+	console.log('post changed:', post);
+});
+
+// subscribe to all entities of a type
+const unsubscribeType = cache.subscribeType(AppBskyActorDefs.profileViewBasicSchema, (key, profile) => {
+	console.log(`profile ${key} changed:`, profile);
+});
+
+// clean up when done
+unsubscribe();
+unsubscribeType();
+```
+
+### custom merge logic
+
+```ts
+cache.define({
+	schema: AppBskyActorDefs.profileViewBasicSchema,
+	key: (profile) => profile.did,
+	// custom merge: prefer existing avatar if new one is missing
+	merge: (existing, incoming) => ({
+		...incoming,
+		avatar: incoming.avatar ?? existing.avatar,
+	}),
+});
+```

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { NormalizedCache } from './store.js';
+export type { NormalizedCacheOptions } from './store.js';
+export type { EntityDefinition, EntitySubscriber, EntityTypeId, TypeSubscriber } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { NormalizedCache } from './store.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/predicates.d.ts

@@ -0,0 +1,14 @@
+import type { ArraySchema, BaseSchema, LiteralSchema, NullableSchema, ObjectSchema, OptionalSchema, VariantSchema } from '@atcute/lexicons/validations';
+/** check if schema is an object schema */
+export declare const isObjectSchema: (schema: BaseSchema<unknown, unknown>) => schema is ObjectSchema<import("@atcute/lexicons/validations").LooseObjectShape>;
+/** check if schema is an array schema */
+export declare const isArraySchema: (schema: BaseSchema<unknown, unknown>) => schema is ArraySchema<BaseSchema<unknown, unknown>>;
+/** check if schema is a variant schema */
+export declare const isVariantSchema: (schema: BaseSchema<unknown, unknown>) => schema is VariantSchema<readonly ObjectSchema<any>[], boolean>;
+/** check if schema is an optional schema */
+export declare const isOptionalSchema: (schema: BaseSchema<unknown, unknown>) => schema is OptionalSchema<BaseSchema<unknown, unknown>, unknown>;
+/** check if schema is a nullable schema */
+export declare const isNullableSchema: (schema: BaseSchema<unknown, unknown>) => schema is NullableSchema<BaseSchema<unknown, unknown>>;
+/** check if schema is a literal schema */
+export declare const isLiteralSchema: (schema: BaseSchema<unknown, unknown>) => schema is LiteralSchema<string | number | boolean>;
+//# sourceMappingURL=predicates.d.ts.map

package/dist/predicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.d.ts","sourceRoot":"","sources":["../lib/predicates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,WAAW,EACX,UAAU,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,cAAc,EACd,aAAa,EACb,MAAM,8BAA8B,CAAC;AAEtC,0CAA0C;AAC1C,eAAO,MAAM,cAAc,2HAE1B,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,aAAa,+FAEzB,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,eAAe,0GAE3B,CAAC;AAEF,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB,2GAE5B,CAAC;AAEF,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB,kGAE5B,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,eAAe,8FAE3B,CAAC"}

package/dist/predicates.js

@@ -0,0 +1,25 @@
+/** check if schema is an object schema */
+export const isObjectSchema = (schema) => {
+    return schema.type === 'object';
+};
+/** check if schema is an array schema */
+export const isArraySchema = (schema) => {
+    return schema.type === 'array';
+};
+/** check if schema is a variant schema */
+export const isVariantSchema = (schema) => {
+    return schema.type === 'variant';
+};
+/** check if schema is an optional schema */
+export const isOptionalSchema = (schema) => {
+    return schema.type === 'optional';
+};
+/** check if schema is a nullable schema */
+export const isNullableSchema = (schema) => {
+    return schema.type === 'nullable';
+};
+/** check if schema is a literal schema */
+export const isLiteralSchema = (schema) => {
+    return schema.type === 'literal';
+};
+//# sourceMappingURL=predicates.js.map

package/dist/predicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.js","sourceRoot":"","sources":["../lib/predicates.ts"],"names":[],"mappings":"AAUA,0CAA0C;AAC1C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAkB,EAA0B,EAAE,CAAC;IAC7E,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC;AAAA,CAChC,CAAC;AAEF,yCAAyC;AACzC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAkB,EAAyB,EAAE,CAAC;IAC3E,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC;AAAA,CAC/B,CAAC;AAEF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAkB,EAA2B,EAAE,CAAC;IAC/E,OAAO,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC;AAAA,CACjC,CAAC;AAEF,4CAA4C;AAC5C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAkB,EAA4B,EAAE,CAAC;IACjF,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC;AAAA,CAClC,CAAC;AAEF,2CAA2C;AAC3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAkB,EAA4B,EAAE,CAAC;IACjF,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC;AAAA,CAClC,CAAC;AAEF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAkB,EAA2B,EAAE,CAAC;IAC/E,OAAO,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC;AAAA,CACjC,CAAC"}

package/dist/store.d.ts

@@ -0,0 +1,94 @@
+import type { BaseSchema, InferOutput, ObjectSchema } from '@atcute/lexicons/validations';
+import type { EntityDefinition, EntitySubscriber, TypeSubscriber } from './types.js';
+export interface NormalizedCacheOptions {
+    wrapEntity?: (entity: unknown) => unknown;
+}
+/**
+ * normalized cache store for AT Protocol responses
+ */
+export declare class NormalizedCache {
+    #private;
+    constructor(options?: NormalizedCacheOptions);
+    /**
+     * register an entity type for normalization
+     * @param definition entity definition with schema, key extractor, and optional merge function
+     */
+    define<T extends ObjectSchema>(definition: EntityDefinition<T>): void;
+    /**
+     * walk response using schema, normalize and cache entities
+     * @param schema the response schema
+     * @param data the response data
+     * @returns response with cached entity refs swapped in
+     */
+    normalize<T extends BaseSchema>(schema: T, data: InferOutput<T>): InferOutput<T>;
+    /**
+     * create a reusable normalizer function for a schema
+     * @param schema the response schema
+     * @returns function that normalizes data according to schema
+     */
+    normalizer<T extends BaseSchema>(schema: T): (data: InferOutput<T>) => InferOutput<T>;
+    /**
+     * get entity from cache by schema and key
+     * @param schema the entity schema
+     * @param key the entity key
+     * @returns the cached entity or undefined if not found/collected
+     */
+    get<T extends ObjectSchema>(schema: T, key: string): InferOutput<T> | undefined;
+    /**
+     * check if entity exists in cache
+     * @param schema the entity schema
+     * @param key the entity key
+     */
+    has(schema: ObjectSchema, key: string): boolean;
+    /**
+     * get all cached entities of a type
+     * @param schema the entity schema
+     * @returns map of key to entity (only includes live refs)
+     */
+    getAll<T extends ObjectSchema>(schema: T): Map<string, InferOutput<T>>;
+    /**
+     * set entity directly in cache
+     * @param schema the entity schema
+     * @param key the entity key
+     * @param entity the entity to cache
+     */
+    set<T extends ObjectSchema>(schema: T, key: string, entity: InferOutput<T>): void;
+    /**
+     * update entity with updater function
+     * @param schema the entity schema
+     * @param key the entity key
+     * @param updater function that returns updated entity
+     * @returns true if entity was found and updated
+     */
+    update<T extends ObjectSchema>(schema: T, key: string, updater: (entity: InferOutput<T>) => InferOutput<T>): boolean;
+    /**
+     * delete entity from cache
+     * @param schema the entity schema
+     * @param key the entity key
+     * @returns true if entity was found and deleted
+     */
+    delete(schema: ObjectSchema, key: string): boolean;
+    /**
+     * delete all entities of a type
+     * @param schema the entity schema
+     */
+    deleteType(schema: ObjectSchema): void;
+    /** clear entire cache */
+    clear(): void;
+    /**
+     * subscribe to changes for a specific entity
+     * @param schema the entity schema
+     * @param key the entity key
+     * @param callback called when entity changes
+     * @returns unsubscribe function
+     */
+    subscribe<T extends ObjectSchema>(schema: T, key: string, callback: EntitySubscriber<InferOutput<T>>): () => void;
+    /**
+     * subscribe to all changes for an entity type
+     * @param schema the entity schema
+     * @param callback called when any entity of this type changes
+     * @returns unsubscribe function
+     */
+    subscribeType<T extends ObjectSchema>(schema: T, callback: TypeSubscriber<InferOutput<T>>): () => void;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../lib/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1F,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAgB,cAAc,EAAE,MAAM,YAAY,CAAC;AAanG,MAAM,WAAW,sBAAsB;IACtC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;CAC1C;AAED;;GAEG;AACH,qBAAa,eAAe;;IAsB3B,YAAY,OAAO,CAAC,EAAE,sBAAsB,EAE3C;IAyDD;;;OAGG;IACH,MAAM,CAAC,CAAC,SAAS,YAAY,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAqBpE;IAED;;;;;OAKG;IACH,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAE/E;IAED;;;;OAIG;IACH,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,CAEpF;IAED;;;;;OAKG;IACH,GAAG,CAAC,CAAC,SAAS,YAAY,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAQ9E;IAED;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ9C;IAED;;;;OAIG;IACH,MAAM,CAAC,CAAC,SAAS,YAAY,EAAE,MAAM,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAgBrE;IAED;;;;;OAKG;IACH,GAAG,CAAC,CAAC,SAAS,YAAY,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAmBhF;IAED;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,SAAS,YAAY,EAC5B,MAAM,EAAE,CAAC,EACT,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,GACjD,OAAO,CAiBT;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAcjD;IAED;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAYrC;IAED,yBAAyB;IACzB,KAAK,IAAI,IAAI,CASZ;IAED;;;;;;OAMG;IACH,SAAS,CAAC,CAAC,SAAS,YAAY,EAC/B,MAAM,EAAE,CAAC,EACT,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACxC,MAAM,IAAI,CAoBZ;IAED;;;;;OAKG;IACH,aAAa,CAAC,CAAC,SAAS,YAAY,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAWrG;CACD"}

package/dist/store.js

@@ -0,0 +1,291 @@
+import { getTypeIdFromSchema } from './types.js';
+import { WalkerCache } from './walker.js';
+/**
+ * normalized cache store for AT Protocol responses
+ */
+export class NormalizedCache {
+    #schemaToTypeId = new Map();
+    #stores = new Map();
+    #wrapEntity;
+    #walkerCache = new WalkerCache({
+        isEntityType: (typeId) => this.#stores.has(typeId),
+        upsertEntity: (typeId, incoming) => this.#upsertEntity(typeId, incoming),
+    });
+    #registry = new FinalizationRegistry((held) => {
+        const store = this.#stores.get(held.typeId);
+        if (store) {
+            const ref = store.entities.get(held.key);
+            // only delete if the ref is actually dead (not replaced with a new one)
+            if (ref !== undefined && ref.deref() === undefined) {
+                store.entities.delete(held.key);
+            }
+        }
+    });
+    constructor(options) {
+        this.#wrapEntity = options?.wrapEntity;
+    }
+    #getTypeId(schema) {
+        let typeId = this.#schemaToTypeId.get(schema);
+        if (typeId === undefined) {
+            typeId = getTypeIdFromSchema(schema);
+            if (typeId !== undefined) {
+                this.#schemaToTypeId.set(schema, typeId);
+            }
+        }
+        return typeId;
+    }
+    #getStore(schema) {
+        const typeId = this.#getTypeId(schema);
+        return typeId ? this.#stores.get(typeId) : undefined;
+    }
+    #notifySubscribers(store, key, entity) {
+        // notify entity-specific subscribers
+        const entitySubs = store.subscribers.get(key);
+        if (entitySubs) {
+            for (const cb of entitySubs) {
+                cb(entity);
+            }
+        }
+        // notify type subscribers
+        for (const cb of store.typeSubscribers) {
+            cb(key, entity);
+        }
+    }
+    #upsertEntity(typeId, incoming) {
+        const store = this.#stores.get(typeId);
+        const key = store.definition.key(incoming);
+        const existingRef = store.entities.get(key);
+        const existing = existingRef?.deref();
+        if (existing !== undefined) {
+            // merge incoming into existing
+            const merge = store.definition.merge;
+            const merged = merge ? merge(existing, incoming) : incoming;
+            Object.assign(existing, merged);
+            this.#notifySubscribers(store, key, existing);
+            return existing;
+        }
+        // new entity - wrap and store it
+        const entity = this.#wrapEntity ? this.#wrapEntity(incoming) : incoming;
+        store.entities.set(key, new WeakRef(entity));
+        this.#registry.register(entity, { typeId, key });
+        this.#notifySubscribers(store, key, entity);
+        return entity;
+    }
+    /**
+     * register an entity type for normalization
+     * @param definition entity definition with schema, key extractor, and optional merge function
+     */
+    define(definition) {
+        const typeId = getTypeIdFromSchema(definition.schema);
+        if (typeId === undefined) {
+            throw new Error('schema must have a $type literal field');
+        }
+        if (this.#stores.has(typeId)) {
+            throw new Error(`entity type "${typeId}" is already defined`);
+        }
+        this.#stores.set(typeId, {
+            definition: definition,
+            entities: new Map(),
+            subscribers: new Map(),
+            typeSubscribers: new Set(),
+        });
+        this.#schemaToTypeId.set(definition.schema, typeId);
+        // invalidate cached walkers since entity types changed
+        this.#walkerCache.invalidate();
+    }
+    /**
+     * walk response using schema, normalize and cache entities
+     * @param schema the response schema
+     * @param data the response data
+     * @returns response with cached entity refs swapped in
+     */
+    normalize(schema, data) {
+        return this.#walkerCache.getWalker(schema)(data);
+    }
+    /**
+     * create a reusable normalizer function for a schema
+     * @param schema the response schema
+     * @returns function that normalizes data according to schema
+     */
+    normalizer(schema) {
+        return (data) => this.normalize(schema, data);
+    }
+    /**
+     * get entity from cache by schema and key
+     * @param schema the entity schema
+     * @param key the entity key
+     * @returns the cached entity or undefined if not found/collected
+     */
+    get(schema, key) {
+        const store = this.#getStore(schema);
+        if (!store) {
+            return undefined;
+        }
+        const ref = store.entities.get(key);
+        return ref?.deref();
+    }
+    /**
+     * check if entity exists in cache
+     * @param schema the entity schema
+     * @param key the entity key
+     */
+    has(schema, key) {
+        const store = this.#getStore(schema);
+        if (!store) {
+            return false;
+        }
+        const ref = store.entities.get(key);
+        return ref?.deref() !== undefined;
+    }
+    /**
+     * get all cached entities of a type
+     * @param schema the entity schema
+     * @returns map of key to entity (only includes live refs)
+     */
+    getAll(schema) {
+        const store = this.#getStore(schema);
+        const result = new Map();
+        if (!store) {
+            return result;
+        }
+        for (const [key, ref] of store.entities) {
+            const entity = ref.deref();
+            if (entity !== undefined) {
+                result.set(key, entity);
+            }
+        }
+        return result;
+    }
+    /**
+     * set entity directly in cache
+     * @param schema the entity schema
+     * @param key the entity key
+     * @param entity the entity to cache
+     */
+    set(schema, key, entity) {
+        const typeId = this.#getTypeId(schema);
+        if (typeId === undefined || !this.#stores.has(typeId)) {
+            throw new Error('schema is not registered');
+        }
+        const store = this.#stores.get(typeId);
+        const existingRef = store.entities.get(key);
+        const existing = existingRef?.deref();
+        if (existing !== undefined) {
+            Object.assign(existing, entity);
+            this.#notifySubscribers(store, key, existing);
+        }
+        else {
+            const wrapped = this.#wrapEntity ? this.#wrapEntity(entity) : entity;
+            store.entities.set(key, new WeakRef(wrapped));
+            this.#registry.register(wrapped, { typeId, key });
+            this.#notifySubscribers(store, key, wrapped);
+        }
+    }
+    /**
+     * update entity with updater function
+     * @param schema the entity schema
+     * @param key the entity key
+     * @param updater function that returns updated entity
+     * @returns true if entity was found and updated
+     */
+    update(schema, key, updater) {
+        const store = this.#getStore(schema);
+        if (!store) {
+            return false;
+        }
+        const ref = store.entities.get(key);
+        const existing = ref?.deref();
+        if (existing === undefined) {
+            return false;
+        }
+        const updated = updater(existing);
+        Object.assign(existing, updated);
+        this.#notifySubscribers(store, key, existing);
+        return true;
+    }
+    /**
+     * delete entity from cache
+     * @param schema the entity schema
+     * @param key the entity key
+     * @returns true if entity was found and deleted
+     */
+    delete(schema, key) {
+        const store = this.#getStore(schema);
+        if (!store) {
+            return false;
+        }
+        const existed = store.entities.has(key);
+        store.entities.delete(key);
+        if (existed) {
+            this.#notifySubscribers(store, key, undefined);
+        }
+        return existed;
+    }
+    /**
+     * delete all entities of a type
+     * @param schema the entity schema
+     */
+    deleteType(schema) {
+        const store = this.#getStore(schema);
+        if (!store) {
+            return;
+        }
+        const keys = [...store.entities.keys()];
+        store.entities.clear();
+        for (const key of keys) {
+            this.#notifySubscribers(store, key, undefined);
+        }
+    }
+    /** clear entire cache */
+    clear() {
+        for (const [_typeId, store] of this.#stores) {
+            const keys = [...store.entities.keys()];
+            store.entities.clear();
+            for (const key of keys) {
+                this.#notifySubscribers(store, key, undefined);
+            }
+        }
+    }
+    /**
+     * subscribe to changes for a specific entity
+     * @param schema the entity schema
+     * @param key the entity key
+     * @param callback called when entity changes
+     * @returns unsubscribe function
+     */
+    subscribe(schema, key, callback) {
+        const store = this.#getStore(schema);
+        if (!store) {
+            throw new Error('schema is not registered');
+        }
+        let subs = store.subscribers.get(key);
+        if (!subs) {
+            subs = new Set();
+            store.subscribers.set(key, subs);
+        }
+        subs.add(callback);
+        return () => {
+            subs.delete(callback);
+            if (subs.size === 0) {
+                store.subscribers.delete(key);
+            }
+        };
+    }
+    /**
+     * subscribe to all changes for an entity type
+     * @param schema the entity schema
+     * @param callback called when any entity of this type changes
+     * @returns unsubscribe function
+     */
+    subscribeType(schema, callback) {
+        const store = this.#getStore(schema);
+        if (!store) {
+            throw new Error('schema is not registered');
+        }
+        store.typeSubscribers.add(callback);
+        return () => {
+            store.typeSubscribers.delete(callback);
+        };
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../lib/store.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,31 @@
+import type { InferOutput, ObjectSchema } from '@atcute/lexicons/validations';
+/** entity type identifier, extracted from schema's $type literal */
+export type EntityTypeId = string;
+/**
+ * definition for an entity type that can be normalized
+ * @template T the object schema type
+ */
+export interface EntityDefinition<T extends ObjectSchema = ObjectSchema> {
+    /** the schema for this entity type */
+    schema: T;
+    /** extract cache key from entity instance */
+    key: (entity: InferOutput<T>) => string;
+    /**
+     * merge strategy when entity already exists in cache
+     * @param existing the currently cached entity
+     * @param incoming the new entity data
+     * @returns partial entity with fields to update
+     */
+    merge?: (existing: InferOutput<T>, incoming: InferOutput<T>) => Partial<InferOutput<T>>;
+}
+/** subscriber callback type */
+export type EntitySubscriber<T> = (entity: T | undefined) => void;
+/** type-level subscriber callback */
+export type TypeSubscriber<T> = (key: string, entity: T | undefined) => void;
+/**
+ * extract the $type literal value from an object schema
+ * @param schema object schema with $type field
+ * @returns the $type string value or undefined
+ */
+export declare const getTypeIdFromSchema: (schema: ObjectSchema<import("@atcute/lexicons/validations").LooseObjectShape>) => string | undefined;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,WAAW,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAI1F,oEAAoE;AACpE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IACtE,sCAAsC;IACtC,MAAM,EAAE,CAAC,CAAC;IACV,6CAA6C;IAC7C,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;IACxC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CACxF;AAED,+BAA+B;AAC/B,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC;AAElE,qCAAqC;AACrC,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,uGAkB/B,CAAC"}

package/dist/types.js

@@ -0,0 +1,22 @@
+import { isLiteralSchema, isOptionalSchema } from './predicates.js';
+/**
+ * extract the $type literal value from an object schema
+ * @param schema object schema with $type field
+ * @returns the $type string value or undefined
+ */
+export const getTypeIdFromSchema = (schema) => {
+    const shape = schema.shape;
+    let typeField = shape.$type;
+    if (typeField === undefined) {
+        return undefined;
+    }
+    // unwrap optional
+    if (isOptionalSchema(typeField)) {
+        typeField = typeField.wrapped;
+    }
+    if (isLiteralSchema(typeField) && typeof typeField.expected === 'string') {
+        return typeField.expected;
+    }
+    return undefined;
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AA6BpE;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAoB,EAA4B,EAAE,CAAC;IACtF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,SAAS,GAA2B,KAAK,CAAC,KAAK,CAAC;IAEpD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,kBAAkB;IAClB,IAAI,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED,IAAI,eAAe,CAAC,SAAS,CAAC,IAAI,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1E,OAAO,SAAS,CAAC,QAAQ,CAAC;IAC3B,CAAC;IAED,OAAO,SAAS,CAAC;AAAA,CACjB,CAAC"}