@statezero/core 0.2.15 → 0.2.17

package/dist/cli/commands/syncActions.js

@@ -92,149 +92,153 @@ Handlebars.registerHelper("formatJsDoc", function (text) {
         .map((line) => ` * ${line}`)
         .join("\n");
 });
-const JS_ACTION_TEMPLATE = `/**
- * This file was auto-generated. Do not make direct changes to the file.
- * Action: {{title}}
- * App: {{app}}
- */
-
-import axios from 'axios';
-import { z } from 'zod';
-import { configInstance, parseStateZeroError } from '{{modulePath}}';
-
-{{#if inputSchemaString}}
-/**
- * Zod schema for the input of {{functionName}}.
- * NOTE: This is an object schema for validating the data payload.
- */
-export const {{functionName}}InputSchema = z.object({ {{{inputSchemaString}}} });
-{{/if}}
-
-{{#if responseSchemaString}}
-/**
- * Zod schema for the response of {{functionName}}.
- */
-export const {{functionName}}ResponseSchema = z.object({ {{{responseSchemaString}}} });
-{{/if}}
-
-/**
-{{#if docstring}}
-{{{formatJsDoc docstring}}}
- *
-{{else}}
- * {{title}}
-{{/if}}
-{{#each tsDocParams}}
- * @param {{{this.type}}} {{this.name}} - {{this.description}}
-{{/each}}
- * @param {Object} [axiosOverrides] - Allows overriding Axios request parameters.
- * @returns {Promise<Object>} A promise that resolves with the action's result.
- */
-export async function {{functionName}}({{{jsFunctionParams}}}) {
-  // Construct the data payload from the function arguments
-  {{#if payloadProperties}}
-  const payload = {
-    {{{payloadProperties}}}
-  };
-  {{else}}
-  const payload = {};
-  {{/if}}
-
-  const config = configInstance.getConfig();
-  const backend = config.backendConfigs['{{configKey}}'];
-
-  if (!backend) {
-    throw new Error(\`No backend configuration found for key: {{configKey}}\`);
-  }
-
-  const baseUrl = backend.API_URL.replace(/\\/+$/, '');
-  const actionUrl = \`\${baseUrl}/actions/{{actionName}}/\`;
-  const headers = backend.getAuthHeaders ? backend.getAuthHeaders() : {};
-
-  try {
-    const response = await axios.post(actionUrl, payload, {
-      headers: { 'Content-Type': 'application/json', ...headers },
-      ...axiosOverrides,
-    });
-
-    {{#if responseSchemaString}}
-    return {{functionName}}ResponseSchema.parse(response.data);
-    {{else}}
-    return response.data;
-    {{/if}}
-  } catch (error) {
-    if (error instanceof z.ZodError) {
-      throw new Error(\`{{title}} failed: Invalid response from server. Details: \${error.message}\`);
-    }
-    
-    if (error.response && error.response.data) {
-      const parsedError = parseStateZeroError(error.response.data);
-      
-      if (Error.captureStackTrace) {
-        Error.captureStackTrace(parsedError, {{functionName}});
-      }
-      
-      throw parsedError;
-    } else if (error.request) {
-      throw new Error(\`{{title}} failed: No response received from server.\`);
-    } else {
-      throw new Error(\`{{title}} failed: \${error.message}\`);
-    }
-  }
-}
-
-export default {{functionName}};
-
-{{functionName}}.actionName = '{{actionName}}';
-{{functionName}}.title = '{{title}}';
-{{functionName}}.app = {{#if app}}'{{app}}'{{else}}null{{/if}};
-{{functionName}}.permissions = [{{#each permissions}}'{{this}}'{{#unless @last}}, {{/unless}}{{/each}}];
-{{functionName}}.configKey = '{{configKey}}';
+const JS_ACTION_TEMPLATE = `/**
+ * This file was auto-generated. Do not make direct changes to the file.
+ * Action: {{title}}
+ * App: {{app}}
+ */
+
+import axios from 'axios';
+import { z } from 'zod';
+import { configInstance, parseStateZeroError, serializeActionPayload } from '{{modulePath}}';
+import actionSchema from './{{schemaFileName}}' assert { type: 'json' };
+
+{{#if inputSchemaString}}
+/**
+ * Zod schema for the input of {{functionName}}.
+ * NOTE: This is an object schema for validating the data payload.
+ */
+export const {{functionName}}InputSchema = z.object({ {{{inputSchemaString}}} });
+{{/if}}
+
+{{#if responseSchemaString}}
+/**
+ * Zod schema for the response of {{functionName}}.
+ */
+export const {{functionName}}ResponseSchema = z.object({ {{{responseSchemaString}}} });
+{{/if}}
+
+/**
+{{#if docstring}}
+{{{formatJsDoc docstring}}}
+ *
+{{else}}
+ * {{title}}
+{{/if}}
+{{#each tsDocParams}}
+ * @param {{{this.type}}} {{this.name}} - {{this.description}}
+{{/each}}
+ * @param {Object} [axiosOverrides] - Allows overriding Axios request parameters.
+ * @returns {Promise<Object>} A promise that resolves with the action's result.
+ */
+export async function {{functionName}}({{{jsFunctionParams}}}) {
+  // Construct the data payload from the function arguments
+  {{#if payloadProperties}}
+  const rawPayload = {
+    {{{payloadProperties}}}
+  };
+  {{else}}
+  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}}'];
+
+  if (!backend) {
+    throw new Error(\`No backend configuration found for key: {{configKey}}\`);
+  }
+
+  const baseUrl = backend.API_URL.replace(/\\/+$/, '');
+  const actionUrl = \`\${baseUrl}/actions/{{actionName}}/\`;
+  const headers = backend.getAuthHeaders ? backend.getAuthHeaders() : {};
+
+  try {
+    const response = await axios.post(actionUrl, payload, {
+      headers: { 'Content-Type': 'application/json', ...headers },
+      ...axiosOverrides,
+    });
+
+    {{#if responseSchemaString}}
+    return {{functionName}}ResponseSchema.parse(response.data);
+    {{else}}
+    return response.data;
+    {{/if}}
+  } catch (error) {
+    if (error instanceof z.ZodError) {
+      throw new Error(\`{{title}} failed: Invalid response from server. Details: \${error.message}\`);
+    }
+    
+    if (error.response && error.response.data) {
+      const parsedError = parseStateZeroError(error.response.data);
+      
+      if (Error.captureStackTrace) {
+        Error.captureStackTrace(parsedError, {{functionName}});
+      }
+      
+      throw parsedError;
+    } else if (error.request) {
+      throw new Error(\`{{title}} failed: No response received from server.\`);
+    } else {
+      throw new Error(\`{{title}} failed: \${error.message}\`);
+    }
+  }
+}
+
+export default {{functionName}};
+
+{{functionName}}.actionName = '{{actionName}}';
+{{functionName}}.title = '{{title}}';
+{{functionName}}.app = {{#if app}}'{{app}}'{{else}}null{{/if}};
+{{functionName}}.permissions = [{{#each permissions}}'{{this}}'{{#unless @last}}, {{/unless}}{{/each}}];
+{{functionName}}.configKey = '{{configKey}}';
 `;
-const TS_ACTION_DECLARATION_TEMPLATE = `/**
- * This file was auto-generated. Do not make direct changes to the file.
- * Action: {{title}}
- * App: {{app}}
- */
-import { z } from 'zod';
-import { AxiosRequestConfig } from 'axios';
-
-{{#if inputTsSchemaString}}
-export type {{functionName}}Input = { {{{inputTsSchemaString}}} };
-{{/if}}
-
-{{#if responseTsSchemaString}}
-export type {{functionName}}Response = { {{{responseTsSchemaString}}} };
-{{else}}
-export type {{functionName}}Response = any;
-{{/if}}
-
-/**
-{{#if docstring}}
-{{{formatJsDoc docstring}}}
- *
-{{else}}
- * {{title}}
-{{/if}}
-{{#each tsDocParams}}
- * @param {{{this.type}}} {{this.name}} - {{this.description}}
-{{/each}}
- * @param {AxiosRequestConfig} [axiosOverrides] - Allows overriding Axios request parameters.
- * @returns {Promise<{{functionName}}Response>} A promise that resolves with the action's result.
- */
-export declare function {{functionName}}(
-  {{{tsFunctionParams}}}
-): Promise<{{functionName}}Response>;
-
-export default {{functionName}};
-
-export declare namespace {{functionName}} {
-  export const actionName: string;
-  export const title: string;
-  export const app: string | null;
-  export const permissions: string[];
-  export const configKey: string;
-}
+const TS_ACTION_DECLARATION_TEMPLATE = `/**
+ * This file was auto-generated. Do not make direct changes to the file.
+ * Action: {{title}}
+ * App: {{app}}
+ */
+import { z } from 'zod';
+import { AxiosRequestConfig } from 'axios';
+
+{{#if inputTsSchemaString}}
+export type {{functionName}}Input = { {{{inputTsSchemaString}}} };
+{{/if}}
+
+{{#if responseTsSchemaString}}
+export type {{functionName}}Response = { {{{responseTsSchemaString}}} };
+{{else}}
+export type {{functionName}}Response = any;
+{{/if}}
+
+/**
+{{#if docstring}}
+{{{formatJsDoc docstring}}}
+ *
+{{else}}
+ * {{title}}
+{{/if}}
+{{#each tsDocParams}}
+ * @param {{{this.type}}} {{this.name}} - {{this.description}}
+{{/each}}
+ * @param {AxiosRequestConfig} [axiosOverrides] - Allows overriding Axios request parameters.
+ * @returns {Promise<{{functionName}}Response>} A promise that resolves with the action's result.
+ */
+export declare function {{functionName}}(
+  {{{tsFunctionParams}}}
+): Promise<{{functionName}}Response>;
+
+export default {{functionName}};
+
+export declare namespace {{functionName}} {
+  export const actionName: string;
+  export const title: string;
+  export const app: string | null;
+  export const permissions: string[];
+  export const configKey: string;
+}
 `;
 const jsActionTemplate = Handlebars.compile(JS_ACTION_TEMPLATE);
 const dtsActionTemplate = Handlebars.compile(TS_ACTION_DECLARATION_TEMPLATE);
@@ -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`);
@@ -495,11 +501,11 @@ async function generateActionRegistry(generatedFiles, backendConfigs) {
         allSchemaImports.add(schemaImportStatement);
         schemasByBackend[backendKey][file.action] = schemaImportName;
     }
-    let registryContent = `/**
- * This file was auto-generated. Do not make direct changes to the file.
- * It provides a registry of all generated actions.
- */
-
+    let registryContent = `/**
+ * This file was auto-generated. Do not make direct changes to the file.
+ * It provides a registry of all generated actions.
+ */
+
 `;
     // Add action imports
     registryContent += Array.from(allImports).sort().join("\n") + "\n\n";
@@ -527,35 +533,35 @@ async function generateActionRegistry(generatedFiles, backendConfigs) {
         registryContent += `  }${index < arr.length - 1 ? "," : ""}\n`;
     });
     registryContent += `};\n\n`;
-    registryContent += `/**
- * Get an action function by name and config key
- * @param {string} actionName - The name of the action
- * @param {string} configKey - The backend config key
- * @returns {Function|null} The action function or null if not found
- */
-export function getAction(actionName, configKey) {
-  const action = ACTION_REGISTRY[configKey]?.[actionName];
-  if (!action) {
-    console.warn(\`Action '\${actionName}' not found for config key '\${configKey}'.\`);
-    return null;
-  }
-  return action;
-}
-
-/**
- * Get the full schema for an action
- * @param {string} actionName - The name of the action
- * @param {string} configKey - The backend config key
- * @returns {Object|null} The action schema or null if not found
- */
-export function getSchema(actionName, configKey) {
-  const schema = SCHEMA_REGISTRY[configKey]?.[actionName];
-  if (!schema) {
-    console.warn(\`Schema for action '\${actionName}' not found for config key '\${configKey}'.\`);
-    return null;
-  }
-  return schema;
-}
+    registryContent += `/**
+ * Get an action function by name and config key
+ * @param {string} actionName - The name of the action
+ * @param {string} configKey - The backend config key
+ * @returns {Function|null} The action function or null if not found
+ */
+export function getAction(actionName, configKey) {
+  const action = ACTION_REGISTRY[configKey]?.[actionName];
+  if (!action) {
+    console.warn(\`Action '\${actionName}' not found for config key '\${configKey}'.\`);
+    return null;
+  }
+  return action;
+}
+
+/**
+ * Get the full schema for an action
+ * @param {string} actionName - The name of the action
+ * @param {string} configKey - The backend config key
+ * @returns {Object|null} The action schema or null if not found
+ */
+export function getSchema(actionName, configKey) {
+  const schema = SCHEMA_REGISTRY[configKey]?.[actionName];
+  if (!schema) {
+    console.warn(\`Schema for action '\${actionName}' not found for config key '\${configKey}'.\`);
+    return null;
+  }
+  return schema;
+}
 `;
     const registryFilePath = path.join(process.cwd(), "action-registry.js");
     await fs.writeFile(registryFilePath, registryContent);
@@ -563,8 +569,8 @@ export function getSchema(actionName, configKey) {
 }
 async function generateAppLevelIndexFiles(generatedFiles, backendConfigs) {
     const filesByBackend = _.groupBy(generatedFiles, "backend");
-    const indexTemplate = Handlebars.compile(`{{#each files}}
-export * from '{{this.relativePath}}';
+    const indexTemplate = Handlebars.compile(`{{#each files}}
+export * from '{{this.relativePath}}';
 {{/each}}`);
     for (const backendName in filesByBackend) {
         const backendFiles = filesByBackend[backendName];
@@ -583,7 +589,7 @@ export * from '{{this.relativePath}}';
             const indexContent = indexTemplate({ files: appIndexExports }).trim();
             await fs.writeFile(path.join(appDir, "index.js"), indexContent);
             await fs.writeFile(path.join(appDir, "index.d.ts"), indexContent);
-            rootExports.push(`export * from './${appName}';`);
+            rootExports.push(`export * from './${appName}/index.js';`);
         }
         const rootIndexContent = rootExports.sort().join("\n");
         // Include backend key in the path for root index files
@@ -606,12 +612,12 @@ async function generateDefaultBackendIndex(backendConfigs) {
     const defaultBackend = backendConfigs['default'];
     const actionsDir = defaultBackend.GENERATED_ACTIONS_DIR;
     // Create top-level index files that re-export from default
-    const indexContent = `/**
- * This file was auto-generated. Do not make direct changes to the file.
- * Re-exports from the 'default' backend for backwards compatibility.
- */
-
-export * from './default/index';
+    const indexContent = `/**
+ * This file was auto-generated. Do not make direct changes to the file.
+ * Re-exports from the 'default' backend for backwards compatibility.
+ */
+
+export * from './default/index.js';
 `;
     const jsIndexPath = path.join(actionsDir, 'index.js');
     const dtsIndexPath = path.join(actionsDir, 'index.d.ts');