@statezero/core 0.2.14 → 0.2.16

package/dist/actions/backend1/django_app/calculate-hash.js

@@ -5,7 +5,8 @@
  */
 import axios from 'axios';
 import { z } from 'zod';
-import { configInstance, parseStateZeroError } from '../../../../src';
+import { configInstance, parseStateZeroError, serializeActionPayload } from '../../../../src';
+import actionSchema from './calculate-hash.schema.json' assert { type: 'json' };
 /**
  * Zod schema for the input of calculateHash.
  * NOTE: This is an object schema for validating the data payload.
@@ -31,10 +32,12 @@ export const calculateHashResponseSchema = z.object({ original_text: z.string(),
  */
 export async function calculateHash(text, algorithm = "sha256", axiosOverrides = {}) {
     // Construct the data payload from the function arguments
-    const payload = {
+    const rawPayload = {
         text,
         algorithm
     };
+    // Serialize payload - handles model instances (extracts PK), files, dates, etc.
+    const payload = serializeActionPayload(rawPayload, actionSchema.input_properties);
     const config = configInstance.getConfig();
     const backend = config.backendConfigs['backend1'];
     if (!backend) {

package/dist/actions/backend1/django_app/get-current-username.js

@@ -5,7 +5,8 @@
  */
 import axios from 'axios';
 import { z } from 'zod';
-import { configInstance, parseStateZeroError } from '../../../../src';
+import { configInstance, parseStateZeroError, serializeActionPayload } from '../../../../src';
+import actionSchema from './get-current-username.schema.json' assert { type: 'json' };
 /**
  * Zod schema for the response of getCurrentUsername.
  */
@@ -19,7 +20,9 @@ export const getCurrentUsernameResponseSchema = z.object({ username: z.string(),
  */
 export async function getCurrentUsername(axiosOverrides = {}) {
     // Construct the data payload from the function arguments
-    const payload = {};
+    const rawPayload = {};
+    // Serialize payload - handles model instances (extracts PK), files, dates, etc.
+    const payload = serializeActionPayload(rawPayload, actionSchema.input_properties);
     const config = configInstance.getConfig();
     const backend = config.backendConfigs['backend1'];
     if (!backend) {

package/dist/actions/backend1/django_app/get-server-status.js

@@ -5,7 +5,8 @@
  */
 import axios from 'axios';
 import { z } from 'zod';
-import { configInstance, parseStateZeroError } from '../../../../src';
+import { configInstance, parseStateZeroError, serializeActionPayload } from '../../../../src';
+import actionSchema from './get-server-status.schema.json' assert { type: 'json' };
 /**
  * Zod schema for the response of getServerStatus.
  */
@@ -22,7 +23,9 @@ export const getServerStatusResponseSchema = z.object({ status: z.string(),
  */
 export async function getServerStatus(axiosOverrides = {}) {
     // Construct the data payload from the function arguments
-    const payload = {};
+    const rawPayload = {};
+    // Serialize payload - handles model instances (extracts PK), files, dates, etc.
+    const payload = serializeActionPayload(rawPayload, actionSchema.input_properties);
     const config = configInstance.getConfig();
     const backend = config.backendConfigs['backend1'];
     if (!backend) {

package/dist/actions/backend1/django_app/get-user-info.js

@@ -5,7 +5,8 @@
  */
 import axios from 'axios';
 import { z } from 'zod';
-import { configInstance, parseStateZeroError } from '../../../../src';
+import { configInstance, parseStateZeroError, serializeActionPayload } from '../../../../src';
+import actionSchema from './get-user-info.schema.json' assert { type: 'json' };
 /**
  * Zod schema for the response of getUserInfo.
  */
@@ -24,7 +25,9 @@ export const getUserInfoResponseSchema = z.object({ username: z.string(),
  */
 export async function getUserInfo(axiosOverrides = {}) {
     // Construct the data payload from the function arguments
-    const payload = {};
+    const rawPayload = {};
+    // Serialize payload - handles model instances (extracts PK), files, dates, etc.
+    const payload = serializeActionPayload(rawPayload, actionSchema.input_properties);
     const config = configInstance.getConfig();
     const backend = config.backendConfigs['backend1'];
     if (!backend) {

package/dist/actions/backend1/django_app/process-data.js

@@ -5,7 +5,8 @@
  */
 import axios from 'axios';
 import { z } from 'zod';
-import { configInstance, parseStateZeroError } from '../../../../src';
+import { configInstance, parseStateZeroError, serializeActionPayload } from '../../../../src';
+import actionSchema from './process-data.schema.json' assert { type: 'json' };
 /**
  * Zod schema for the input of processData.
  * NOTE: This is an object schema for validating the data payload.
@@ -29,10 +30,12 @@ export const processDataResponseSchema = z.object({ operation: z.string(),
  */
 export async function processData(data, operation, axiosOverrides = {}) {
     // Construct the data payload from the function arguments
-    const payload = {
+    const rawPayload = {
         data,
         operation
     };
+    // Serialize payload - handles model instances (extracts PK), files, dates, etc.
+    const payload = serializeActionPayload(rawPayload, actionSchema.input_properties);
     const config = configInstance.getConfig();
     const backend = config.backendConfigs['backend1'];
     if (!backend) {

package/dist/actions/backend1/django_app/send-notification.js

@@ -5,7 +5,8 @@
  */
 import axios from 'axios';
 import { z } from 'zod';
-import { configInstance, parseStateZeroError } from '../../../../src';
+import { configInstance, parseStateZeroError, serializeActionPayload } from '../../../../src';
+import actionSchema from './send-notification.schema.json' assert { type: 'json' };
 /**
  * Zod schema for the input of sendNotification.
  * NOTE: This is an object schema for validating the data payload.
@@ -31,11 +32,13 @@ export const sendNotificationResponseSchema = z.object({ success: z.boolean(),
  */
 export async function sendNotification(message, recipients, priority = "low", axiosOverrides = {}) {
     // Construct the data payload from the function arguments
-    const payload = {
+    const rawPayload = {
         message,
         recipients,
         priority
     };
+    // Serialize payload - handles model instances (extracts PK), files, dates, etc.
+    const payload = serializeActionPayload(rawPayload, actionSchema.input_properties);
     const config = configInstance.getConfig();
     const backend = config.backendConfigs['backend1'];
     if (!backend) {

package/dist/actions/default/django_app/calculate-hash.js

@@ -5,7 +5,8 @@
  */
 import axios from 'axios';
 import { z } from 'zod';
-import { configInstance, parseStateZeroError } from '../../../../src';
+import { configInstance, parseStateZeroError, serializeActionPayload } from '../../../../src';
+import actionSchema from './calculate-hash.schema.json' assert { type: 'json' };
 /**
  * Zod schema for the input of calculateHash.
  * NOTE: This is an object schema for validating the data payload.
@@ -31,10 +32,12 @@ export const calculateHashResponseSchema = z.object({ original_text: z.string(),
  */
 export async function calculateHash(text, algorithm = "sha256", axiosOverrides = {}) {
     // Construct the data payload from the function arguments
-    const payload = {
+    const rawPayload = {
         text,
         algorithm
     };
+    // Serialize payload - handles model instances (extracts PK), files, dates, etc.
+    const payload = serializeActionPayload(rawPayload, actionSchema.input_properties);
     const config = configInstance.getConfig();
     const backend = config.backendConfigs['default'];
     if (!backend) {

package/dist/actions/default/django_app/get-current-username.js

@@ -5,7 +5,8 @@
  */
 import axios from 'axios';
 import { z } from 'zod';
-import { configInstance, parseStateZeroError } from '../../../../src';
+import { configInstance, parseStateZeroError, serializeActionPayload } from '../../../../src';
+import actionSchema from './get-current-username.schema.json' assert { type: 'json' };
 /**
  * Zod schema for the response of getCurrentUsername.
  */
@@ -19,7 +20,9 @@ export const getCurrentUsernameResponseSchema = z.object({ username: z.string(),
  */
 export async function getCurrentUsername(axiosOverrides = {}) {
     // Construct the data payload from the function arguments
-    const payload = {};
+    const rawPayload = {};
+    // Serialize payload - handles model instances (extracts PK), files, dates, etc.
+    const payload = serializeActionPayload(rawPayload, actionSchema.input_properties);
     const config = configInstance.getConfig();
     const backend = config.backendConfigs['default'];
     if (!backend) {

package/dist/actions/default/django_app/get-server-status.js

@@ -5,7 +5,8 @@
  */
 import axios from 'axios';
 import { z } from 'zod';
-import { configInstance, parseStateZeroError } from '../../../../src';
+import { configInstance, parseStateZeroError, serializeActionPayload } from '../../../../src';
+import actionSchema from './get-server-status.schema.json' assert { type: 'json' };
 /**
  * Zod schema for the response of getServerStatus.
  */
@@ -22,7 +23,9 @@ export const getServerStatusResponseSchema = z.object({ status: z.string(),
  */
 export async function getServerStatus(axiosOverrides = {}) {
     // Construct the data payload from the function arguments
-    const payload = {};
+    const rawPayload = {};
+    // Serialize payload - handles model instances (extracts PK), files, dates, etc.
+    const payload = serializeActionPayload(rawPayload, actionSchema.input_properties);
     const config = configInstance.getConfig();
     const backend = config.backendConfigs['default'];
     if (!backend) {

package/dist/actions/default/django_app/get-user-info.js

@@ -5,7 +5,8 @@
  */
 import axios from 'axios';
 import { z } from 'zod';
-import { configInstance, parseStateZeroError } from '../../../../src';
+import { configInstance, parseStateZeroError, serializeActionPayload } from '../../../../src';
+import actionSchema from './get-user-info.schema.json' assert { type: 'json' };
 /**
  * Zod schema for the response of getUserInfo.
  */
@@ -24,7 +25,9 @@ export const getUserInfoResponseSchema = z.object({ username: z.string(),
  */
 export async function getUserInfo(axiosOverrides = {}) {
     // Construct the data payload from the function arguments
-    const payload = {};
+    const rawPayload = {};
+    // Serialize payload - handles model instances (extracts PK), files, dates, etc.
+    const payload = serializeActionPayload(rawPayload, actionSchema.input_properties);
     const config = configInstance.getConfig();
     const backend = config.backendConfigs['default'];
     if (!backend) {

package/dist/actions/default/django_app/process-data.js

@@ -5,7 +5,8 @@
  */
 import axios from 'axios';
 import { z } from 'zod';
-import { configInstance, parseStateZeroError } from '../../../../src';
+import { configInstance, parseStateZeroError, serializeActionPayload } from '../../../../src';
+import actionSchema from './process-data.schema.json' assert { type: 'json' };
 /**
  * Zod schema for the input of processData.
  * NOTE: This is an object schema for validating the data payload.
@@ -29,10 +30,12 @@ export const processDataResponseSchema = z.object({ operation: z.string(),
  */
 export async function processData(data, operation, axiosOverrides = {}) {
     // Construct the data payload from the function arguments
-    const payload = {
+    const rawPayload = {
         data,
         operation
     };
+    // Serialize payload - handles model instances (extracts PK), files, dates, etc.
+    const payload = serializeActionPayload(rawPayload, actionSchema.input_properties);
     const config = configInstance.getConfig();
     const backend = config.backendConfigs['default'];
     if (!backend) {

package/dist/actions/default/django_app/send-notification.js

@@ -5,7 +5,8 @@
  */
 import axios from 'axios';
 import { z } from 'zod';
-import { configInstance, parseStateZeroError } from '../../../../src';
+import { configInstance, parseStateZeroError, serializeActionPayload } from '../../../../src';
+import actionSchema from './send-notification.schema.json' assert { type: 'json' };
 /**
  * Zod schema for the input of sendNotification.
  * NOTE: This is an object schema for validating the data payload.
@@ -31,11 +32,13 @@ export const sendNotificationResponseSchema = z.object({ success: z.boolean(),
  */
 export async function sendNotification(message, recipients, priority = "low", axiosOverrides = {}) {
     // Construct the data payload from the function arguments
-    const payload = {
+    const rawPayload = {
         message,
         recipients,
         priority
     };
+    // Serialize payload - handles model instances (extracts PK), files, dates, etc.
+    const payload = serializeActionPayload(rawPayload, actionSchema.input_properties);
     const config = configInstance.getConfig();
     const backend = config.backendConfigs['default'];
     if (!backend) {

package/dist/cli/commands/syncActions.js

@@ -100,7 +100,8 @@ const JS_ACTION_TEMPLATE = `/**
 
 import axios from 'axios';
 import { z } from 'zod';
-import { configInstance, parseStateZeroError } from '{{modulePath}}';
+import { configInstance, parseStateZeroError, serializeActionPayload } from '{{modulePath}}';
+import actionSchema from './{{schemaFileName}}' assert { type: 'json' };
 
 {{#if inputSchemaString}}
 /**
@@ -133,13 +134,16 @@ export const {{functionName}}ResponseSchema = z.object({ {{{responseSchemaString
 export async function {{functionName}}({{{jsFunctionParams}}}) {
   // Construct the data payload from the function arguments
   {{#if payloadProperties}}
-  const payload = {
+  const rawPayload = {
     {{{payloadProperties}}}
   };
   {{else}}
-  const payload = {};
+  const rawPayload = {};
   {{/if}}
 
+  // Serialize payload - handles model instances (extracts PK), files, dates, etc.
+  const payload = serializeActionPayload(rawPayload, actionSchema.input_properties);
+
   const config = configInstance.getConfig();
   const backend = config.backendConfigs['{{configKey}}'];
 
@@ -444,10 +448,12 @@ async function generateActionFile(backend, actionName, actionDefinition) {
     // Always include the backend key as the top-level folder
     const outDir = path.join(backend.GENERATED_ACTIONS_DIR, backend.NAME, appName);
     await fs.mkdir(outDir, { recursive: true });
-    const templateData = prepareActionTemplateData(modulePath, functionName, actionName, actionDefinition, backend.NAME);
     const fileName = _.kebabCase(actionName);
+    const schemaFileName = `${fileName}.schema.json`;
+    const templateData = prepareActionTemplateData(modulePath, functionName, actionName, actionDefinition, backend.NAME);
+    templateData.schemaFileName = schemaFileName;
     // Write the raw schema file (like models do)
-    const schemaFilePath = path.join(outDir, `${fileName}.schema.json`);
+    const schemaFilePath = path.join(outDir, schemaFileName);
     await fs.writeFile(schemaFilePath, JSON.stringify(actionDefinition, null, 2));
     // Write JS and TS files
     const jsFilePath = path.join(outDir, `${fileName}.js`);

package/dist/filtering/localFiltering.js

@@ -83,6 +83,7 @@ function processFieldPath(fieldPath, value, ModelClass, options = {}) {
     let currentModel = ModelClass;
     let processedPath = [];
     let isRelationship = false;
+    let isM2M = false; // Track if this is a many-to-many relationship
     let finalFieldName = null; // Track the actual field name for schema lookup
     for (let i = 0; i < fieldParts.length; i++) {
         let part = fieldParts[i];
@@ -109,6 +110,7 @@ function processFieldPath(fieldPath, value, ModelClass, options = {}) {
                 // For many-to-many relationships, don't append the primary key field
                 // M2M fields store an array of PKs directly, not objects
                 if (relationshipType === 'many-to-many') {
+                    isM2M = true;
                     // Keep path as-is (e.g., 'comprehensive_models')
                     // Sift will handle array membership check
                     finalFieldName = part;
@@ -154,7 +156,7 @@ function processFieldPath(fieldPath, value, ModelClass, options = {}) {
     }
     // Handle the single lookup operation if present
     if (lookup) {
-        return createOperatorFromLookup(finalPath, lookup, normalizedValue, isRelationship, currentModel, finalFieldName);
+        return createOperatorFromLookup(finalPath, lookup, normalizedValue, isRelationship, currentModel, finalFieldName, isM2M);
     }
     // If there's no explicit lookup and this is a relationship field,
     // we've already appended the PK field name to the path
@@ -201,9 +203,10 @@ function createDatePartComparisonOperator(field, datePart, comparisonOperator, v
  * @param {boolean} isRelationship - Whether the field is a relationship
  * @param {Class} ModelClass - The model class (unused, for future extensibility)
  * @param {string} finalFieldName - The final field name (unused, for future extensibility)
+ * @param {boolean} isM2M - Whether the field is a many-to-many relationship
  * @returns {Object} Object with field name and sift operator
  */
-function createOperatorFromLookup(field, lookup, value, isRelationship, ModelClass, finalFieldName) {
+function createOperatorFromLookup(field, lookup, value, isRelationship, ModelClass, finalFieldName, isM2M = false) {
     // Helper function to escape special characters in regex
     function escapeRegExp(string) {
         return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
@@ -212,7 +215,23 @@ function createOperatorFromLookup(field, lookup, value, isRelationship, ModelCla
     if (isRelationship) {
         // For relationship fields with lookups, we need special handling
         if (lookup === 'isnull') {
-            // Check for both undefined and null values
+            if (isM2M) {
+                // For M2M fields, isnull=True means null OR empty array, but not undefined because
+                // that can mean the field was not fetched so we can't be sure
+                // isnull=False means has at least one item
+                // Use a custom function since sift doesn't support $or inside field operators
+                return {
+                    field,
+                    operator: {
+                        $where: function (fieldValue) {
+                            const isEmpty = fieldValue === null ||
+                                (Array.isArray(fieldValue) && fieldValue.length === 0);
+                            return value ? isEmpty : !isEmpty;
+                        }
+                    }
+                };
+            }
+            // For FK/O2O, check for both undefined and null values
             return {
                 field,
                 operator: value ? { $in: [null, undefined] } : { $nin: [null, undefined] }

package/dist/flavours/django/serializers.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Serializes an action payload based on the action's input schema.
+ * Automatically handles model instances (extracts PK), files, dates, etc.
+ *
+ * @param {Object} payload - The raw payload with potentially model instances
+ * @param {Object} inputProperties - The action's input_properties schema
+ * @returns {Object} Serialized payload ready for API transmission
+ */
+export function serializeActionPayload(payload: Object, inputProperties: Object): Object;
 export namespace fileFieldSerializer {
     function toInternal(value: any, context?: {}): any;
     function toLive(value: any, context?: {}): any;

package/dist/flavours/django/serializers.js

@@ -186,6 +186,37 @@ const serializers = {
         "many-to-many": m2mFieldSerializer,
     },
 };
+/**
+ * Serializes an action payload based on the action's input schema.
+ * Automatically handles model instances (extracts PK), files, dates, etc.
+ *
+ * @param {Object} payload - The raw payload with potentially model instances
+ * @param {Object} inputProperties - The action's input_properties schema
+ * @returns {Object} Serialized payload ready for API transmission
+ */
+export function serializeActionPayload(payload, inputProperties) {
+    if (!payload || !inputProperties)
+        return payload;
+    const serializedPayload = {};
+    for (const [field, value] of Object.entries(payload)) {
+        const fieldSchema = inputProperties[field];
+        if (!fieldSchema || value === undefined) {
+            serializedPayload[field] = value;
+            continue;
+        }
+        const { type, format } = fieldSchema;
+        // Check if we have a serializer for this type/format combo
+        const typeSerializers = serializers[type];
+        const serializer = typeSerializers?.[format];
+        if (serializer) {
+            serializedPayload[field] = serializer.toInternal(value, { field });
+        }
+        else {
+            serializedPayload[field] = value;
+        }
+    }
+    return serializedPayload;
+}
 export class ModelSerializer {
     constructor(modelClass) {
         this.modelClass = modelClass;

package/dist/index.d.ts

@@ -36,4 +36,5 @@ import { cleanupEventHandler } from "./syncEngine/stores/operationEventHandlers.
 import { setAdapters } from "./reactiveAdaptor.js";
 import { wrapReactiveModel } from "./reactiveAdaptor.js";
 import { wrapReactiveQuerySet } from "./reactiveAdaptor.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 };
+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 };

package/dist/index.js

@@ -13,6 +13,7 @@ import { QuerySet } from "./flavours/django/querySet.js";
 import { Manager } from "./flavours/django/manager.js";
 import { Model } from "./flavours/django/model.js";
 import { FileObject } from "./flavours/django/files.js";
+import { serializeActionPayload } from "./flavours/django/serializers.js";
 // Configuration
 import { setConfig, getConfig, setBackendConfig, initializeEventReceiver, configInstance, getModelClass, } from "./config.js";
 import { setAdapters, wrapReactiveModel, wrapReactiveQuerySet, } from "./reactiveAdaptor.js";
@@ -36,4 +37,6 @@ Q, StateZeroError, ValidationError, DoesNotExist, PermissionDenied, MultipleObje
 // Configuration
 setConfig, getConfig, setBackendConfig, initializeEventReceiver, configInstance, getModelClass, 
 // Reactivity framework integration
-initEventHandler, cleanupEventHandler, setAdapters, wrapReactiveModel, wrapReactiveQuerySet, };
+initEventHandler, cleanupEventHandler, setAdapters, wrapReactiveModel, wrapReactiveQuerySet, 
+// Action utilities
+serializeActionPayload, };

package/package.json

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