@flexsurfer/reflex 0.1.11 → 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,6 +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** - [`@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  
@@ -28,6 +30,9 @@ After many years of building applications with re-frame in the ClojureScript wor
 
 ```bash
 npm install @flexsurfer/reflex
+npm install --save-dev @flexsurfer/reflex-devtools
+
+npx reflex-devtools
 ```
 
 ### Basic Example
@@ -38,8 +43,13 @@ import {
   regEvent, 
   regSub, 
   dispatch, 
-  useSubscription 
+  useSubscription,
+  enableTracing
 } from '@flexsurfer/reflex';
+import { enableDevtools } from '@flexsurfer/reflex-devtools'
+
+enableTracing()
+enableDevtools();
 
 // Initialize your app database
 initAppDb({ counter: 0 });

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;
@@ -627,9 +635,7 @@ function resetTracing() {
 }
 function registerTraceCb(key, cb) {
   if (!traceEnabled) {
-    console.warn(
-      "Tracing is not enabled; call enableTracing() before registering callbacks"
-    );
+    consoleLog("warn", "[reflex] [trace] Tracing is not enabled; call enableTracing() before registering callbacks");
     return;
   }
   traceCbs.set(key, cb);
@@ -645,7 +651,7 @@ function scheduleFlush() {
       try {
         cb(batch);
       } catch (e) {
-        console.error("Error in trace callback", e);
+        consoleLog("warn", "Error in trace callback", e);
       }
     }
   }, DEBOUNCE_TIME);
@@ -810,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;
 }
@@ -971,7 +977,7 @@ var Reaction = class _Reaction {
         operation: this.subVector?.[0] ?? "",
         opType: "sub/dispose",
         tags: {
-          subVector: this.subVector,
+          queryV: this.subVector,
           reaction: this.id
         }
       },
@@ -1198,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;
@@ -559,9 +563,7 @@ function resetTracing() {
 }
 function registerTraceCb(key, cb) {
   if (!traceEnabled) {
-    console.warn(
-      "Tracing is not enabled; call enableTracing() before registering callbacks"
-    );
+    consoleLog("warn", "[reflex] [trace] Tracing is not enabled; call enableTracing() before registering callbacks");
     return;
   }
   traceCbs.set(key, cb);
@@ -577,7 +579,7 @@ function scheduleFlush() {
       try {
         cb(batch);
       } catch (e) {
-        console.error("Error in trace callback", e);
+        consoleLog("warn", "Error in trace callback", e);
       }
     }
   }, DEBOUNCE_TIME);
@@ -742,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;
 }
@@ -903,7 +905,7 @@ var Reaction = class _Reaction {
         operation: this.subVector?.[0] ?? "",
         opType: "sub/dispose",
         tags: {
-          subVector: this.subVector,
+          queryV: this.subVector,
           reaction: this.id
         }
       },
@@ -1129,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.11",
+  "version": "0.1.13",
   "license": "MIT",
   "repository": {
     "type": "git",