@statezero/core 0.2.26 → 0.2.28

package/dist/errorHandler.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Register a global error handler for StateZero errors.
+ * Errors still propagate to call sites - this is for side effects like toasts.
+ *
+ * @param {Function} handler - Callback receiving the error
+ * @returns {Function} Unsubscribe function
+ *
+ * @example
+ * // In a Vue component with access to toast
+ * const unsubscribe = onStateZeroError((error) => {
+ *   toast.error(error.message)
+ * })
+ * onUnmounted(() => unsubscribe())
+ */
+export function onStateZeroError(handler: Function): Function;
+/**
+ * Emit an error to all registered handlers.
+ * @param {Error} error - The error that occurred
+ */
+export function emitError(error: Error): void;
+export const errorEmitter: any;

package/dist/errorHandler.js

@@ -0,0 +1,27 @@
+import mitt from 'mitt';
+export const errorEmitter = mitt();
+/**
+ * Register a global error handler for StateZero errors.
+ * Errors still propagate to call sites - this is for side effects like toasts.
+ *
+ * @param {Function} handler - Callback receiving the error
+ * @returns {Function} Unsubscribe function
+ *
+ * @example
+ * // In a Vue component with access to toast
+ * const unsubscribe = onStateZeroError((error) => {
+ *   toast.error(error.message)
+ * })
+ * onUnmounted(() => unsubscribe())
+ */
+export function onStateZeroError(handler) {
+    errorEmitter.on('error', handler);
+    return () => errorEmitter.off('error', handler);
+}
+/**
+ * Emit an error to all registered handlers.
+ * @param {Error} error - The error that occurred
+ */
+export function emitError(error) {
+    errorEmitter.emit('error', error);
+}

package/dist/filtering/localFiltering.js

@@ -164,7 +164,18 @@ function processFieldPath(fieldPath, value, ModelClass, options = {}) {
             if (isLastPart) {
                 break;
             }
-            // If it's not the last part but it's a regular field,
+            // Check if this is a JSON field - if so, we can traverse into it
+            const fieldSchema = currentModel.schema?.properties?.[part];
+            if (fieldSchema && fieldSchema.format === 'json') {
+                // This is a JSON field - add remaining parts as nested key access
+                // e.g., json_field__nested__active becomes json_field.nested.active
+                const remainingParts = fieldParts.slice(i + 1);
+                processedPath.push(...remainingParts);
+                // The final field name for schema lookup is still the JSON field itself
+                // (remaining parts are just keys within the JSON)
+                break;
+            }
+            // If it's not the last part and not a JSON field,
             // we can't continue traversal
             throw new Error(`Field '${part}' in '${fieldPath}' is not a relationship field and cannot be traversed.`);
         }

package/dist/flavours/django/errors.js

@@ -1,3 +1,4 @@
+import { emitError } from '../../errorHandler.js';
 /**
  * @typedef {Object} IErrorResponse
  * @property {number} status - The HTTP status code.
@@ -28,6 +29,7 @@ export class StateZeroError extends Error {
         this.detail = detail;
         this.status = status;
         Object.setPrototypeOf(this, new.target.prototype);
+        emitError(this);
     }
     /**
      * Returns a full error message including the detail.

package/dist/index.d.ts

@@ -37,4 +37,5 @@ import { setAdapters } from "./reactiveAdaptor.js";
 import { wrapReactiveModel } from "./reactiveAdaptor.js";
 import { wrapReactiveQuerySet } from "./reactiveAdaptor.js";
 import { serializeActionPayload } from "./flavours/django/serializers.js";
-export { EventType, PusherEventReceiver, setEventReceiver, getEventReceiver, setNamespaceResolver, setupStateZero, resetStateZero, FileObject, querysetStoreRegistry, modelStoreRegistry, metricRegistry, syncManager, Operation, operationRegistry, Q, StateZeroError, ValidationError, DoesNotExist, PermissionDenied, MultipleObjectsReturned, ASTValidationError, ConfigError, parseStateZeroError, QuerySet, Manager, ResultTuple, Model, setConfig, getConfig, setBackendConfig, initializeEventReceiver, configInstance, getModelClass, initEventHandler, cleanupEventHandler, setAdapters, wrapReactiveModel, wrapReactiveQuerySet, serializeActionPayload };
+import { onStateZeroError } from "./errorHandler.js";
+export { EventType, PusherEventReceiver, setEventReceiver, getEventReceiver, setNamespaceResolver, setupStateZero, resetStateZero, FileObject, querysetStoreRegistry, modelStoreRegistry, metricRegistry, syncManager, Operation, operationRegistry, Q, StateZeroError, ValidationError, DoesNotExist, PermissionDenied, MultipleObjectsReturned, ASTValidationError, ConfigError, parseStateZeroError, QuerySet, Manager, ResultTuple, Model, setConfig, getConfig, setBackendConfig, initializeEventReceiver, configInstance, getModelClass, initEventHandler, cleanupEventHandler, setAdapters, wrapReactiveModel, wrapReactiveQuerySet, serializeActionPayload, onStateZeroError };

package/dist/index.js

@@ -20,6 +20,7 @@ import { setAdapters, wrapReactiveModel, wrapReactiveQuerySet, } from "./reactiv
 import { syncManager } from "./syncEngine/sync.js";
 import { initEventHandler, cleanupEventHandler, } from "./syncEngine/stores/operationEventHandlers.js";
 import { resetStateZero } from "./reset.js";
+import { onStateZeroError } from "./errorHandler.js";
 // Explicitly export everything
 export { 
 // Core event receivers
@@ -39,4 +40,6 @@ setConfig, getConfig, setBackendConfig, initializeEventReceiver, configInstance,
 // Reactivity framework integration
 initEventHandler, cleanupEventHandler, setAdapters, wrapReactiveModel, wrapReactiveQuerySet, 
 // Action utilities
-serializeActionPayload, };
+serializeActionPayload, 
+// Error handling
+onStateZeroError, };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statezero/core",
-  "version": "0.2.26",
+  "version": "0.2.28",
   "type": "module",
   "module": "ESNext",
   "description": "The type-safe frontend client for StateZero - connect directly to your backend models with zero boilerplate",