edges-svelte 0.5.7 → 0.6.1

package/README.md

@@ -8,7 +8,7 @@ No context boilerplate. No hydration headaches. Just drop-in SSR-compatible stat
 
 - 🔄 Unified state for server and client
 - 🧠 Persistent per-request memory via `AsyncLocalStorage`
-- 💧 Tiny API — no subscriptions needed unless you want them
+- 💧 Tiny API
 - 💥 Instant serialization without magic
 - 🧩 Provider-based dependency injection, zero runtime overhead
 
@@ -119,7 +119,15 @@ import { createProvider } from 'edges-svelte';
 const myProvider = createProvider({
 	cacheKey: 'MyUniqueProviderName',
 	factory: ({ createState }, params) => {
-		const userData = createState('userData', () => fetchUserData(params.userId));
+		const myService = new MyService();
+		const someData = createState('userData', () => undefined);
+
+		const setUserData = async () => {
+			await myService.getData().then((user) => {
+				userData.set(user);
+			});
+		};
+
 		return { userData };
 	}
 });

package/dist/server/EdgesHandle.js

@@ -18,7 +18,15 @@ export const edgesHandle = async (event, callback, silentChromeDevtools = false)
         RequestContext.current = () => {
             const context = storage.getStore();
             if (context === undefined) {
-                throw new Error('Request symbol has not been initialized');
+                throw new Error('[Edge-S] State access attempted outside of a valid request context.\n' +
+                    '\nThis usually happens if you are calling a provider or using `createState`/`createDerivedState` at the module (top) level.\n' +
+                    '\n✅ Correct usage:\n' +
+                    '  - Inside a `load` function (page.server.ts / page.ts)\n' +
+                    '  - Inside Svelte components (in <script>)\n' +
+                    '  - Inside `handle` hook or other request-scoped logic\n' +
+                    '\n🚫 Incorrect usage:\n' +
+                    '  - Calling providers or states directly at the top level of a module (e.g., outside any function or component)\n' +
+                    '\nTo fix this, wrap your provider or state call inside a function, component, or request handler.\n');
             }
             return context;
         };

package/package.json

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