edges-svelte 0.5.3 → 0.5.5

package/README.md

@@ -1,8 +1,8 @@
-# Edge-S
+# EdgeS
 
 ### A blazing-fast, extremely lightweight and SSR-friendly store for Svelte.
 
-**Edge-S** brings seamless, per-request state management to Svelte apps — fully reactive, server-aware, and serialization-safe by default.
+**EdgeS** brings seamless, per-request state management to Svelte apps — fully reactive, server-aware, and serialization-safe by default.
 
 No context boilerplate. No hydration headaches. Just drop-in SSR-compatible state primitives with built-in support for client-side reactivity and server-side isolation.
 
@@ -26,7 +26,7 @@ npm install edges-svelte
 
 ## Setup
 
-To enable **Edge-S**, wrap your SvelteKit `handle` hook and serialize the state in `transformPageChunks`:
+To enable **EdgeS**, wrap your SvelteKit `handle` hook and serialize the state in `transformPageChunks`:
 
 ```ts
 // hooks.server.ts
@@ -97,6 +97,36 @@ const myProvider = createProvider({
 
 ---
 
+## Provider Caching with `cacheKey`
+
+To improve performance and avoid redundant computations, **EdgeS** supports caching providers by a unique `cacheKey`.
+
+### What is `cacheKey`?
+
+- A `cacheKey` is a string uniquely identifying a specific provider invocation.
+- It enables **caching the result of the provider’s factory function**
+- Prevents repeated calls to the same provider with identical parameters.
+  With caching:
+
+- The provider is called **only once per unique `cacheKey`** within a request.
+- Subsequent calls with the same key return the cached result instantly.
+
+### How to use `cacheKey`
+
+```ts
+import { createProvider } from 'edges-svelte';
+
+const myProvider = createProvider({
+	cacheKey: (params) => params.userId,
+	factory: ({ createState }, params) => {
+		const userData = createState('userData', () => fetchUserData(params.userId));
+		return { userData };
+	}
+});
+```
+
+---
+
 ## Core Concepts
 
 ### SSR-safe state access
@@ -213,7 +243,7 @@ type EdgesHandle = (
 
 ### Why not just use `writable, derived`?
 
-Because `writable` and `derived` shares state between requests when used on the server. That means users could leak state into each other’s responses. **Edge-S** solves that by isolating state per request.
+Because `writable` and `derived` shares state between requests when used on the server. That means users could leak state into each other’s responses. **EdgeS** solves that by isolating state per request.
 
 ### Difference between `createState` and `createRawState`
 

package/dist/provider/Provider.js

@@ -27,7 +27,6 @@ export const createProvider = (options) => {
             if (!context.data.providers) {
                 context.data.providers = new Map();
             }
-            console.log(RequestContext.current().data.providers);
             const map = context.data.providers;
             if (!map.has(cacheKey)) {
                 map.set(cacheKey, options.factory(deps));

package/dist/store/State.svelte.js

@@ -86,15 +86,22 @@ export const createDerivedState = (stores, deriveFn) => {
     if (browser) {
         return derived(stores, deriveFn);
     }
-    const values = stores.map((s) => {
-        let value;
-        s.subscribe((v) => (value = v))();
-        return value;
-    });
     return {
         subscribe(run) {
-            run(deriveFn(values));
-            return () => { };
+            const values = new Array(stores.length);
+            let initializedCount = 0;
+            const unsubscribers = stores.map((store, i) => store.subscribe((value) => {
+                values[i] = value;
+                if (initializedCount < stores.length) {
+                    initializedCount++;
+                }
+                if (initializedCount >= stores.length) {
+                    run(deriveFn(values));
+                }
+            }));
+            return () => {
+                unsubscribers.forEach((unsub) => unsub());
+            };
         }
     };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edges-svelte",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "license": "MIT",
   "author": "Pixel1917",
   "description": "A blazing-fast, extremely lightweight and SSR-friendly store for Svelte",