@everfur/sdk 0.1.0

package/dist/cacheEpoch-DknKn3S0.d.cts

@@ -0,0 +1,36 @@
+/**
+ * Non-secret durable key/value storage. Absent from config falls back to an in-memory implementation
+ * (createInMemoryKv in runtime.ts), so the SDK never blanks on a host without persistence.
+ */
+interface KvPort {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    /** Prefix scan over stored keys; host adapters back this with their native key enumeration. */
+    keys(prefix: string): Promise<readonly string[]>;
+}
+
+/** KvPort key holding the last acted-on epoch. Non-secret durable state only. */
+declare const CACHE_EPOCH_STORAGE_KEY = "everfur.petState.cacheEpoch";
+/**
+ * The platform image-cache seam. RN: `Image.clearMemoryCache` / `Image.clearDiskCache` (expo-image);
+ * Flutter: `PaintingBinding.instance.imageCache`. Injected so core stays native-free.
+ */
+interface ImageCachePort {
+    clearMemoryCache(): void | Promise<void>;
+    clearDiskCache(): void | Promise<void>;
+}
+interface CacheEpochGuard {
+    /** Purge iff serverEpoch strictly exceeds the last acted-on. Returns true iff a purge fired. Never throws. */
+    sync(serverEpoch: number | undefined): Promise<boolean>;
+}
+/**
+ * Build a cache-epoch guard bound to one KvPort + ImageCachePort. One guard instance per controller so N
+ * mounted views sharing the controller fire exactly one purge per epoch increase.
+ */
+declare function createCacheEpochGuard(deps: {
+    readonly kv: KvPort;
+    readonly cache: ImageCachePort;
+}): CacheEpochGuard;
+
+export { type CacheEpochGuard as C, type ImageCachePort as I, type KvPort as K, CACHE_EPOCH_STORAGE_KEY as a, createCacheEpochGuard as c };

package/dist/cacheEpoch-DknKn3S0.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Non-secret durable key/value storage. Absent from config falls back to an in-memory implementation
+ * (createInMemoryKv in runtime.ts), so the SDK never blanks on a host without persistence.
+ */
+interface KvPort {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    /** Prefix scan over stored keys; host adapters back this with their native key enumeration. */
+    keys(prefix: string): Promise<readonly string[]>;
+}
+
+/** KvPort key holding the last acted-on epoch. Non-secret durable state only. */
+declare const CACHE_EPOCH_STORAGE_KEY = "everfur.petState.cacheEpoch";
+/**
+ * The platform image-cache seam. RN: `Image.clearMemoryCache` / `Image.clearDiskCache` (expo-image);
+ * Flutter: `PaintingBinding.instance.imageCache`. Injected so core stays native-free.
+ */
+interface ImageCachePort {
+    clearMemoryCache(): void | Promise<void>;
+    clearDiskCache(): void | Promise<void>;
+}
+interface CacheEpochGuard {
+    /** Purge iff serverEpoch strictly exceeds the last acted-on. Returns true iff a purge fired. Never throws. */
+    sync(serverEpoch: number | undefined): Promise<boolean>;
+}
+/**
+ * Build a cache-epoch guard bound to one KvPort + ImageCachePort. One guard instance per controller so N
+ * mounted views sharing the controller fire exactly one purge per epoch increase.
+ */
+declare function createCacheEpochGuard(deps: {
+    readonly kv: KvPort;
+    readonly cache: ImageCachePort;
+}): CacheEpochGuard;
+
+export { type CacheEpochGuard as C, type ImageCachePort as I, type KvPort as K, CACHE_EPOCH_STORAGE_KEY as a, createCacheEpochGuard as c };