@flexsurfer/reflex 0.1.12 → 0.1.13

package/README.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="reflex-logo-300kb.png" alt="Reflex Logo" width="200" />
+  <img src="reflex_logo.jpg" alt="Reflex Logo" width="200" />
 </div>
 
 **re-frame for the JavaScript world**
@@ -20,8 +20,8 @@ After many years of building applications with re-frame in the ClojureScript wor
 🧩 **Composable Architecture** - Build complex apps from simple, reusable pieces  
 🔄 **Reactive Subscriptions** - UI automatically updates when state changes  
 🌐 **Multi-Platform Support** - With effects separation, it's super easy to support multiple platforms with the same codebase, including web, mobile, and desktop  
-🤖 **AI Friendly** - Reviewing AI-generated changes is easier because all logic is expressed through pure, isolated functions, making each change understandable, verifiable, and deterministic.
-🛠️ **Integrated DevTools** - Reflex-devtools provides deep visibility into your app’s state, events, and subscriptions in real time, forming a powerful combo with Reflex for effective development and debugging.
+🤖 **AI Friendly** - Reviewing AI-generated changes is easier because all logic is expressed through pure, isolated functions, making each change understandable, verifiable, and deterministic.  
+🛠️ **Integrated DevTools** - [`@flexsurfer/reflex-devtools`](https://github.com/flexsurfer/reflex-devtools) provides deep visibility into your app’s state, events, and subscriptions in real time, forming a powerful combo with Reflex for effective development and debugging.  
 ⚡ **Interceptor Pattern** - Powerful middleware system for cross-cutting concerns  
 🛡️ **Type Safety** - Full TypeScript support with excellent IDE experience  
 🧪 **Testability** - Pure functions make testing straightforward and reliable  

package/dist/index.cjs

@@ -30,7 +30,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  DISPATCH: () => DISPATCH,
+  DISPATCH_LATER: () => DISPATCH_LATER,
   HotReloadWrapper: () => HotReloadWrapper,
+  NOW: () => NOW,
+  RANDOM: () => RANDOM,
   clearGlobalInterceptors: () => clearGlobalInterceptors,
   clearHandlers: () => clearHandlers,
   clearHotReloadCallbacks: () => clearHotReloadCallbacks,
@@ -314,8 +318,8 @@ function execute(eventV, interceptors) {
   try {
     return executeInterceptors(ctx);
   } catch (e) {
-    const reFrameError = mergeExData(e, { eventV });
-    errorHandler(e.cause || e, reFrameError);
+    const reflexError = mergeExData(e, { eventV });
+    errorHandler(e.cause || e, reflexError);
     return ctx;
   }
 }
@@ -343,11 +347,13 @@ function getInjectCofxInterceptor(id, value) {
     }
   };
 }
-regCoeffect("now", (coeffects) => ({
+var NOW = "now";
+var RANDOM = "random";
+regCoeffect(NOW, (coeffects) => ({
   ...coeffects,
   now: Date.now()
 }));
-regCoeffect("random", (coeffects) => ({
+regCoeffect(RANDOM, (coeffects) => ({
   ...coeffects,
   random: Math.random()
 }));
@@ -532,6 +538,8 @@ var doFxInterceptor = {
     return context;
   }
 };
+var DISPATCH_LATER = "dispatch-later";
+var DISPATCH = "dispatch";
 function dispatchLater(effect) {
   const { ms, dispatch: eventToDispatch } = effect;
   if (!Array.isArray(eventToDispatch) || typeof ms !== "number") {
@@ -543,10 +551,10 @@ function dispatchLater(effect) {
   }
   setTimeout(() => dispatch(eventToDispatch), Math.max(0, ms));
 }
-regEffect("dispatch-later", (value) => {
+regEffect(DISPATCH_LATER, (value) => {
   dispatchLater(value);
 });
-regEffect("dispatch", (value) => {
+regEffect(DISPATCH, (value) => {
   if (!Array.isArray(value)) {
     consoleLog("error", "[reflex] ignoring bad dispatch value. Expected a vector, but got:", value);
     return;
@@ -808,11 +816,11 @@ function handle(eventV) {
 function regEventErrorHandler(handler) {
   registerHandler("error", "event-handler", handler);
 }
-function defaultErrorHandler(originalError, reFrameError) {
+function defaultErrorHandler(originalError, reflexError) {
   consoleLog("error", "[reflex] Interceptor Exception:", {
     originalError,
-    reFrameError,
-    data: reFrameError.data
+    reflexError,
+    data: reflexError.data
   });
   throw originalError;
 }
@@ -1196,7 +1204,11 @@ function HotReloadWrapper({ children }) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DISPATCH,
+  DISPATCH_LATER,
   HotReloadWrapper,
+  NOW,
+  RANDOM,
   clearGlobalInterceptors,
   clearHandlers,
   clearHotReloadCallbacks,

package/dist/index.d.cts

@@ -7,7 +7,7 @@ type EventVector = [Id, ...any[]];
 type EventHandler<T = Record<string, any>> = (coeffects: CoEffects<T>, ...params: any[]) => Effects | void;
 type EffectHandler = (value: any) => void;
 type CoEffectHandler<T = Record<string, any>> = (coeffects: CoEffects<T>, value?: any) => CoEffects<T>;
-type ErrorHandler = (originalError: Error, reFrameError: Error & {
+type ErrorHandler = (originalError: Error, reflexError: Error & {
     data: any;
 }) => void;
 type SubVector = [Id, ...any[]];
@@ -57,16 +57,16 @@ declare function regEvent<T = Record<string, any>>(id: Id, handler: EventHandler
  * Only one handler can be registered. Registering a new handler clears the existing handler.
  *
  * This handler function has the signature:
- * `(originalError: Error, reFrameError: Error & { data: any }) => void`
+ * `(originalError: Error, reflexError: Error & { data: any }) => void`
  *
  * - `originalError`: A platform-native Error object.
  *    Represents the original error thrown by user code.
  *    This is the error you see when no handler is registered.
  *
- * - `reFrameError`: An Error object with additional data.
+ * - `reflexError`: An Error object with additional data.
  *    Includes the stacktrace of reflex's internal functions,
  *    and extra data about the interceptor process.
- *    Access `reFrameError.data` to get this info.
+ *    Access `reflexError.data` to get this info.
  *
  *    The data includes:
  *    - `interceptor`: the `id` of the throwing interceptor.
@@ -77,7 +77,7 @@ declare function regEventErrorHandler(handler: ErrorHandler): void;
 /**
  * Default error handler that logs errors to console
  */
-declare function defaultErrorHandler(originalError: Error, reFrameError: Error & {
+declare function defaultErrorHandler(originalError: Error, reflexError: Error & {
     data: any;
 }): void;
 
@@ -85,8 +85,12 @@ declare function regSub<R>(id: Id, computeFn?: (...values: any[]) => R, depsFn?:
 declare function getSubscriptionValue<T>(subVector: SubVector): T;
 
 declare function regEffect(id: string, handler: EffectHandler): void;
+declare const DISPATCH_LATER = "dispatch-later";
+declare const DISPATCH = "dispatch";
 
 declare function regCoeffect(id: string, handler: CoEffectHandler): void;
+declare const NOW = "now";
+declare const RANDOM = "random";
 
 /**
  * Register a global interceptor
@@ -202,4 +206,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, getAppDb, getGlobalInterceptors, getHandler, getSubscriptionValue, initAppDb, isDebugEnabled, regCoeffect, regEffect, regEvent, regEventErrorHandler, regGlobalInterceptor, regSub, registerHotReloadCallback, registerTraceCb, setDebugEnabled, setupSubsHotReload, throttleAndDispatch, triggerHotReload, useHotReload, useHotReloadKey, useSubscription };
+export { CoEffectHandler, CoEffects, Context, DISPATCH, DISPATCH_LATER, Db, DispatchLaterEffect, EffectHandler, Effects, ErrorHandler, EventHandler, EventVector, HotReloadWrapper, Id, Interceptor, NOW, RANDOM, SubVector, clearGlobalInterceptors, clearHandlers, clearHotReloadCallbacks, clearReactions, clearSubs, debounceAndDispatch, defaultErrorHandler, disableTracing, dispatch, enableTracePrint, enableTracing, getAppDb, 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

@@ -7,7 +7,7 @@ type EventVector = [Id, ...any[]];
 type EventHandler<T = Record<string, any>> = (coeffects: CoEffects<T>, ...params: any[]) => Effects | void;
 type EffectHandler = (value: any) => void;
 type CoEffectHandler<T = Record<string, any>> = (coeffects: CoEffects<T>, value?: any) => CoEffects<T>;
-type ErrorHandler = (originalError: Error, reFrameError: Error & {
+type ErrorHandler = (originalError: Error, reflexError: Error & {
     data: any;
 }) => void;
 type SubVector = [Id, ...any[]];
@@ -57,16 +57,16 @@ declare function regEvent<T = Record<string, any>>(id: Id, handler: EventHandler
  * Only one handler can be registered. Registering a new handler clears the existing handler.
  *
  * This handler function has the signature:
- * `(originalError: Error, reFrameError: Error & { data: any }) => void`
+ * `(originalError: Error, reflexError: Error & { data: any }) => void`
  *
  * - `originalError`: A platform-native Error object.
  *    Represents the original error thrown by user code.
  *    This is the error you see when no handler is registered.
  *
- * - `reFrameError`: An Error object with additional data.
+ * - `reflexError`: An Error object with additional data.
  *    Includes the stacktrace of reflex's internal functions,
  *    and extra data about the interceptor process.
- *    Access `reFrameError.data` to get this info.
+ *    Access `reflexError.data` to get this info.
  *
  *    The data includes:
  *    - `interceptor`: the `id` of the throwing interceptor.
@@ -77,7 +77,7 @@ declare function regEventErrorHandler(handler: ErrorHandler): void;
 /**
  * Default error handler that logs errors to console
  */
-declare function defaultErrorHandler(originalError: Error, reFrameError: Error & {
+declare function defaultErrorHandler(originalError: Error, reflexError: Error & {
     data: any;
 }): void;
 
@@ -85,8 +85,12 @@ declare function regSub<R>(id: Id, computeFn?: (...values: any[]) => R, depsFn?:
 declare function getSubscriptionValue<T>(subVector: SubVector): T;
 
 declare function regEffect(id: string, handler: EffectHandler): void;
+declare const DISPATCH_LATER = "dispatch-later";
+declare const DISPATCH = "dispatch";
 
 declare function regCoeffect(id: string, handler: CoEffectHandler): void;
+declare const NOW = "now";
+declare const RANDOM = "random";
 
 /**
  * Register a global interceptor
@@ -202,4 +206,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, getAppDb, getGlobalInterceptors, getHandler, getSubscriptionValue, initAppDb, isDebugEnabled, regCoeffect, regEffect, regEvent, regEventErrorHandler, regGlobalInterceptor, regSub, registerHotReloadCallback, registerTraceCb, setDebugEnabled, setupSubsHotReload, throttleAndDispatch, triggerHotReload, useHotReload, useHotReloadKey, useSubscription };
+export { CoEffectHandler, CoEffects, Context, DISPATCH, DISPATCH_LATER, Db, DispatchLaterEffect, EffectHandler, Effects, ErrorHandler, EventHandler, EventVector, HotReloadWrapper, Id, Interceptor, NOW, RANDOM, SubVector, clearGlobalInterceptors, clearHandlers, clearHotReloadCallbacks, clearReactions, clearSubs, debounceAndDispatch, defaultErrorHandler, disableTracing, dispatch, enableTracePrint, enableTracing, getAppDb, getGlobalInterceptors, getHandler, getSubscriptionValue, initAppDb, isDebugEnabled, regCoeffect, regEffect, regEvent, regEventErrorHandler, regGlobalInterceptor, regSub, registerHotReloadCallback, registerTraceCb, setDebugEnabled, setupSubsHotReload, throttleAndDispatch, triggerHotReload, useHotReload, useHotReloadKey, useSubscription };

package/dist/index.mjs

@@ -246,8 +246,8 @@ function execute(eventV, interceptors) {
   try {
     return executeInterceptors(ctx);
   } catch (e) {
-    const reFrameError = mergeExData(e, { eventV });
-    errorHandler(e.cause || e, reFrameError);
+    const reflexError = mergeExData(e, { eventV });
+    errorHandler(e.cause || e, reflexError);
     return ctx;
   }
 }
@@ -275,11 +275,13 @@ function getInjectCofxInterceptor(id, value) {
     }
   };
 }
-regCoeffect("now", (coeffects) => ({
+var NOW = "now";
+var RANDOM = "random";
+regCoeffect(NOW, (coeffects) => ({
   ...coeffects,
   now: Date.now()
 }));
-regCoeffect("random", (coeffects) => ({
+regCoeffect(RANDOM, (coeffects) => ({
   ...coeffects,
   random: Math.random()
 }));
@@ -464,6 +466,8 @@ var doFxInterceptor = {
     return context;
   }
 };
+var DISPATCH_LATER = "dispatch-later";
+var DISPATCH = "dispatch";
 function dispatchLater(effect) {
   const { ms, dispatch: eventToDispatch } = effect;
   if (!Array.isArray(eventToDispatch) || typeof ms !== "number") {
@@ -475,10 +479,10 @@ function dispatchLater(effect) {
   }
   setTimeout(() => dispatch(eventToDispatch), Math.max(0, ms));
 }
-regEffect("dispatch-later", (value) => {
+regEffect(DISPATCH_LATER, (value) => {
   dispatchLater(value);
 });
-regEffect("dispatch", (value) => {
+regEffect(DISPATCH, (value) => {
   if (!Array.isArray(value)) {
     consoleLog("error", "[reflex] ignoring bad dispatch value. Expected a vector, but got:", value);
     return;
@@ -740,11 +744,11 @@ function handle(eventV) {
 function regEventErrorHandler(handler) {
   registerHandler("error", "event-handler", handler);
 }
-function defaultErrorHandler(originalError, reFrameError) {
+function defaultErrorHandler(originalError, reflexError) {
   consoleLog("error", "[reflex] Interceptor Exception:", {
     originalError,
-    reFrameError,
-    data: reFrameError.data
+    reflexError,
+    data: reflexError.data
   });
   throw originalError;
 }
@@ -1127,7 +1131,11 @@ function HotReloadWrapper({ children }) {
   }
 }
 export {
+  DISPATCH,
+  DISPATCH_LATER,
   HotReloadWrapper,
+  NOW,
+  RANDOM,
   clearGlobalInterceptors,
   clearHandlers,
   clearHotReloadCallbacks,

package/package.json

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