@statezero/core 0.2.15 → 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/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.15",
+  "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",