Add support for loading actions from .action files

Refactored project action logic into a separate .action.ts file and updated the loader to automatically load actions from .action.js/.action.ts files. Added tests and fixtures to verify that actions are correctly loaded and attached to object configs.

Author: hotlong

examples/basic-usage/src/objects/projects.action.ts

@@ -0,0 +1,19 @@
+import { ObjectQLContext } from '@objectql/core';
+
+export const listenTo = 'projects';
+
+export const complete = async (ctx: ObjectQLContext, params: { id: string, comment?: string }) => {
+    const { id, comment } = params;
+    console.log(`[Action] Completing project ${id} by ${ctx.userId}. Comment: ${comment}`);
+    
+    // Use the context to get a repo for this object
+    const repo = ctx.object('projects');
+    
+    // Update the project status
+    await repo.update(id, { 
+        status: 'completed',
+        description: comment ? `Completed with comment: ${comment}` : undefined
+    });
+    
+    return { success: true, message: "Project completed" };
+};

examples/basic-usage/src/objects/projects.hook.ts

@@ -19,21 +19,5 @@ export async function beforeCreate(context: HookContext) {
     }
 }
 
-export const actions = {
-    complete: async (ctx: ObjectQLContext, params: { id: string, comment?: string }) => {
-        const { id, comment } = params;
-        console.log(`[Action] Completing project ${id} by ${ctx.userId}. Comment: ${comment}`);
-        
-        // Use the context to get a repo for this object
-        const repo = ctx.object('projects');
-        
-        // Update the project status
-        await repo.update(id, { 
-            status: 'completed',
-            description: comment ? `Completed with comment: ${comment}` : undefined
-        });
-        
-        return { success: true, message: "Project completed" };
-    }
-};
+// Actions are now in projects.action.ts
 

packages/core/src/loader.ts

@@ -114,6 +114,46 @@ export function loadObjectConfigs(dir: string): Record<string, ObjectConfig> {
             console.error(`Error loading hook from ${file}:`, e);
         }
     }
+
+    // 3. Load Actions (.action.js, .action.ts)
+    const actionFiles = glob.sync(['**/*.action.{js,ts}'], {
+        cwd: dir,
+        absolute: true
+    });
+
+    for (const file of actionFiles) {
+        try {
+            const actionModule = require(file);
+            let objectName = actionModule.listenTo;
+            
+            if (!objectName) {
+                const basename = path.basename(file);
+                const match = basename.match(/^(.+)\.action\.(ts|js)$/);
+                if (match) {
+                    objectName = match[1];
+                }
+            }
+
+            if (objectName && configs[objectName]) {
+                 if (!configs[objectName].actions) {
+                     configs[objectName].actions = {};
+                 }
+                 
+                 // Treat all exported functions as actions
+                 for (const [key, value] of Object.entries(actionModule)) {
+                     if (key === 'listenTo') continue;
+                     if (typeof value === 'function') {
+                         if (!configs[objectName].actions![key]) {
+                             configs[objectName].actions![key] = {};
+                         }
+                         configs[objectName].actions![key].handler = value as any;
+                     }
+                 }
+            }
+        } catch (e) {
+            console.error(`Error loading action from ${file}:`, e);
+        }
+    }
 
     return configs;
 }

packages/core/test/fixtures/project.action.ts

@@ -0,0 +1,6 @@
+// Fixture for testing action loader
+export const listenTo = 'project';
+
+export async function closeProject(ctx: any, params: any) {
+    return { success: true };
+}

packages/core/test/loader.test.ts

@@ -11,4 +11,12 @@ describe('Loader', () => {
         expect(configs['project'].fields).toBeDefined();
         expect(configs['project'].fields.name).toBeDefined();
     });
+
+    it('should load actions from .action.ts files', () => {
+        const fixturesDir = path.join(__dirname, 'fixtures');
+        const configs = loadObjectConfigs(fixturesDir);
+        expect(configs['project'].actions).toBeDefined();
+        expect(configs['project'].actions!.closeProject).toBeDefined();
+        expect(typeof configs['project'].actions!.closeProject.handler).toBe('function');
+    });
 });