@flexsurfer/reflex 0.1.4 → 0.1.6

package/README.md

@@ -16,7 +16,7 @@ A reactive, functional state management library that brings the elegance and pow
 
 ## ✨ Why Reflex?
 
-After 10+ years of building applications with re-frame in the ClojureScript world, I wanted to bring the same architectural elegance to the JavaScript/TypeScript ecosystem. Reflex is not just another state management library—it's a battle-tested pattern that promotes:
+After many years of building applications with re-frame in the ClojureScript world, I wanted to bring the same architectural elegance to the JavaScript/TypeScript ecosystem. Reflex is not just another state management library—it's a battle-tested pattern that promotes:
 
 🎯 **Predictable State Management** - Unidirectional data flow with pure functions  
 🧩 **Composable Architecture** - Build complex apps from simple, reusable pieces  
@@ -266,7 +266,9 @@ regSub('count');
 - [re-frame Documentation](https://day8.github.io/re-frame/re-frame/) - The original and comprehensive guide to understanding the philosophy and patterns
 - Step-by-Step Tutorial - TBD
 - API Reference - TBD
-- Examples - TBD
+- Examples
+  - [TodoMVC](https://github.com/flexsurfer/reflex/tree/main/examples/todomvc) - Classic todo app implementation showcasing core reflex patterns
+  - [Einbürgerungstest](https://github.com/flexsurfer/einburgerungstest/) - German citizenship test app built with reflex ([Live Demo](https://www.ebtest.org/))
 - Best Practices - TBD
 
 ## 🤝 Contributing

package/dist/index.cjs

@@ -43,6 +43,7 @@ __export(src_exports, {
   enableTracePrint: () => enableTracePrint,
   enableTracing: () => enableTracing,
   getGlobalInterceptors: () => getGlobalInterceptors,
+  getHandler: () => getHandler,
   getSubscriptionValue: () => getSubscriptionValue,
   initAppDb: () => initAppDb,
   isDebugEnabled: () => isDebugEnabled,
@@ -1206,6 +1207,7 @@ function HotReloadWrapper({ children }) {
   enableTracePrint,
   enableTracing,
   getGlobalInterceptors,
+  getHandler,
   getSubscriptionValue,
   initAppDb,
   isDebugEnabled,

package/dist/index.d.cts

@@ -11,6 +11,8 @@ type ErrorHandler = (originalError: Error, reFrameError: Error & {
     data: any;
 }) => void;
 type SubVector = [Id, ...any[]];
+type SubHandler = (...values: any[]) => any;
+type SubDepsHandler = (...params: any[]) => SubVector[];
 type Effects = [string, any][];
 interface DispatchLaterEffect {
     ms: number;
@@ -108,6 +110,8 @@ declare function setDebugEnabled(enabled: boolean): void;
 declare function isDebugEnabled(): boolean;
 
 type Kind = 'event' | 'fx' | 'cofx' | 'sub' | 'subDeps' | 'error';
+type RegistryHandler = EventHandler | EffectHandler | CoEffectHandler | ErrorHandler | SubHandler | SubDepsHandler;
+declare function getHandler<T extends RegistryHandler = RegistryHandler>(kind: Kind, id: Id): T | undefined;
 declare function clearHandlers(): void;
 declare function clearHandlers(kind: Kind): void;
 declare function clearHandlers(kind: Kind, id: string): void;
@@ -200,4 +204,4 @@ declare function disableTracing(): void;
 declare function registerTraceCb(key: string, cb: TraceCallback): void;
 declare function enableTracePrint(): void;
 
-export { CoEffectHandler, CoEffects, Context, Db, DispatchLaterEffect, EffectHandler, Effects, ErrorHandler, EventHandler, EventVector, HotReloadWrapper, Id, Interceptor, SubVector, clearGlobalInterceptors, clearHandlers, clearHotReloadCallbacks, clearReactions, clearSubs, debounceAndDispatch, defaultErrorHandler, disableTracing, dispatch, enableTracePrint, enableTracing, getGlobalInterceptors, getSubscriptionValue, initAppDb, isDebugEnabled, regCoeffect, regEffect, regEvent, regEventErrorHandler, regGlobalInterceptor, regSub, registerHotReloadCallback, registerTraceCb, setDebugEnabled, setupSubsHotReload, throttleAndDispatch, triggerHotReload, useHotReload, useHotReloadKey, useSubscription };
+export { CoEffectHandler, CoEffects, Context, Db, DispatchLaterEffect, EffectHandler, Effects, ErrorHandler, EventHandler, EventVector, HotReloadWrapper, Id, Interceptor, SubVector, clearGlobalInterceptors, clearHandlers, clearHotReloadCallbacks, clearReactions, clearSubs, debounceAndDispatch, defaultErrorHandler, disableTracing, dispatch, enableTracePrint, enableTracing, getGlobalInterceptors, getHandler, getSubscriptionValue, initAppDb, isDebugEnabled, regCoeffect, regEffect, regEvent, regEventErrorHandler, regGlobalInterceptor, regSub, registerHotReloadCallback, registerTraceCb, setDebugEnabled, setupSubsHotReload, throttleAndDispatch, triggerHotReload, useHotReload, useHotReloadKey, useSubscription };

package/dist/index.d.ts

@@ -11,6 +11,8 @@ type ErrorHandler = (originalError: Error, reFrameError: Error & {
     data: any;
 }) => void;
 type SubVector = [Id, ...any[]];
+type SubHandler = (...values: any[]) => any;
+type SubDepsHandler = (...params: any[]) => SubVector[];
 type Effects = [string, any][];
 interface DispatchLaterEffect {
     ms: number;
@@ -108,6 +110,8 @@ declare function setDebugEnabled(enabled: boolean): void;
 declare function isDebugEnabled(): boolean;
 
 type Kind = 'event' | 'fx' | 'cofx' | 'sub' | 'subDeps' | 'error';
+type RegistryHandler = EventHandler | EffectHandler | CoEffectHandler | ErrorHandler | SubHandler | SubDepsHandler;
+declare function getHandler<T extends RegistryHandler = RegistryHandler>(kind: Kind, id: Id): T | undefined;
 declare function clearHandlers(): void;
 declare function clearHandlers(kind: Kind): void;
 declare function clearHandlers(kind: Kind, id: string): void;
@@ -200,4 +204,4 @@ declare function disableTracing(): void;
 declare function registerTraceCb(key: string, cb: TraceCallback): void;
 declare function enableTracePrint(): void;
 
-export { CoEffectHandler, CoEffects, Context, Db, DispatchLaterEffect, EffectHandler, Effects, ErrorHandler, EventHandler, EventVector, HotReloadWrapper, Id, Interceptor, SubVector, clearGlobalInterceptors, clearHandlers, clearHotReloadCallbacks, clearReactions, clearSubs, debounceAndDispatch, defaultErrorHandler, disableTracing, dispatch, enableTracePrint, enableTracing, getGlobalInterceptors, getSubscriptionValue, initAppDb, isDebugEnabled, regCoeffect, regEffect, regEvent, regEventErrorHandler, regGlobalInterceptor, regSub, registerHotReloadCallback, registerTraceCb, setDebugEnabled, setupSubsHotReload, throttleAndDispatch, triggerHotReload, useHotReload, useHotReloadKey, useSubscription };
+export { CoEffectHandler, CoEffects, Context, Db, DispatchLaterEffect, EffectHandler, Effects, ErrorHandler, EventHandler, EventVector, HotReloadWrapper, Id, Interceptor, SubVector, clearGlobalInterceptors, clearHandlers, clearHotReloadCallbacks, clearReactions, clearSubs, debounceAndDispatch, defaultErrorHandler, disableTracing, dispatch, enableTracePrint, enableTracing, getGlobalInterceptors, getHandler, getSubscriptionValue, initAppDb, isDebugEnabled, regCoeffect, regEffect, regEvent, regEventErrorHandler, regGlobalInterceptor, regSub, registerHotReloadCallback, registerTraceCb, setDebugEnabled, setupSubsHotReload, throttleAndDispatch, triggerHotReload, useHotReload, useHotReloadKey, useSubscription };

package/dist/index.mjs

@@ -1139,6 +1139,7 @@ export {
   enableTracePrint,
   enableTracing,
   getGlobalInterceptors,
+  getHandler,
   getSubscriptionValue,
   initAppDb,
   isDebugEnabled,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flexsurfer/reflex",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "license": "MIT",
   "repository": {
     "type": "git",