@motiadev/core 0.1.0-alpha.4 → 0.1.0-alpha.6

package/README.md

@@ -0,0 +1,142 @@
+# @motiadev/core
+
+Core functionality for the Motia framework, providing the foundation for building event-driven workflows.
+
+## Installation
+
+```bash
+npm install @motiadev/core
+# or
+yarn add @motiadev/core
+# or
+pnpm add @motiadev/core
+```
+
+## Overview
+
+`@motiadev/core` is the foundation of the Motia framework, providing:
+
+- Event-driven architecture with pub/sub capabilities
+- Multi-language support (TypeScript, Python, Ruby)
+- State management
+- Cron job scheduling
+- API route handling
+- Logging infrastructure
+
+## Key Components
+
+### Server
+
+Create and manage an HTTP server for handling API requests:
+
+```typescript
+import { createServer } from '@motiadev/core'
+
+const server = await createServer(lockedData, eventManager, stateAdapter, config)
+```
+
+### Event Management
+
+Publish and subscribe to events across your application:
+
+```typescript
+import { createEventManager } from '@motiadev/core'
+
+const eventManager = createEventManager()
+
+// Subscribe to events
+eventManager.subscribe({
+  event: 'user.created',
+  handlerName: 'sendWelcomeEmail',
+  filePath: '/path/to/handler.ts',
+  handler: (event) => {
+    // Handle the event
+  }
+})
+
+// Emit events
+eventManager.emit({
+  topic: 'user.created',
+  data: { userId: '123' },
+  traceId: 'trace-123',
+  logger: logger
+})
+```
+
+### Step Handlers
+
+Create handlers for different types of steps (API, Event, Cron):
+
+```typescript
+import { createStepHandlers } from '@motiadev/core'
+
+const stepHandlers = createStepHandlers(lockedData, eventManager, state, config)
+```
+
+### State Management
+
+Manage application state with different adapters:
+
+```typescript
+import { createStateAdapter } from '@motiadev/core'
+
+const stateAdapter = createStateAdapter({
+  adapter: 'redis',
+  host: 'localhost',
+  port: 6379
+})
+
+// Use state in your handlers
+await state.set(traceId, 'key', value)
+const value = await state.get(traceId, 'key')
+```
+
+### Cron Jobs
+
+Schedule and manage cron jobs:
+
+```typescript
+import { setupCronHandlers } from '@motiadev/core'
+
+const cronManager = setupCronHandlers(lockedData, eventManager, state, loggerFactory)
+```
+
+### Logging
+
+Use the built-in logging system:
+
+```typescript
+import { globalLogger } from '@motiadev/core'
+
+globalLogger.info('Application started')
+globalLogger.error('Something went wrong', { error: err })
+```
+
+## Multi-language Support
+
+Motia supports writing step handlers in multiple languages:
+
+- TypeScript/JavaScript
+- Python
+- Ruby
+
+Each language has its own runner that communicates with the core framework.
+
+## Types
+
+The package exports TypeScript types for all components:
+
+```typescript
+import { 
+  Event, 
+  FlowContext, 
+  ApiRouteConfig, 
+  EventConfig, 
+  CronConfig 
+} from '@motiadev/core'
+```
+
+## License
+
+This package is part of the Motia framework and is licensed under the same terms.
+```

package/dist/src/flows-config-endpoint.d.ts

@@ -0,0 +1,2 @@
+import { Express } from 'express';
+export declare const flowsConfigEndpoint: (app: Express, baseDir: string) => void;

package/dist/src/flows-config-endpoint.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flowsConfigEndpoint = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const flowsConfigEndpoint = (app, baseDir) => {
+    const configPath = path_1.default.join(baseDir, 'motia-workbench.json');
+    app.post('/flows/:id/config', (req, res) => {
+        const newFlowConfig = req.body;
+        try {
+            if (!fs_1.default.existsSync(configPath)) {
+                fs_1.default.writeFileSync(configPath, JSON.stringify({}, null, 2));
+            }
+            const existingConfig = JSON.parse(fs_1.default.readFileSync(configPath, 'utf8'));
+            const updatedConfig = {
+                ...existingConfig,
+            };
+            Object.entries(newFlowConfig).forEach(([flowName, filePathPositions]) => {
+                updatedConfig[flowName] = {
+                    ...(updatedConfig[flowName] || {}),
+                    ...filePathPositions,
+                };
+            });
+            fs_1.default.writeFileSync(configPath, JSON.stringify(updatedConfig, null, 2));
+            res.status(200).send({ message: 'Flow config saved successfully' });
+        }
+        catch (error) {
+            console.error('Error saving flow config:', error);
+            res.status(500).json({ error: 'Failed to save flow config' });
+        }
+    });
+    app.get('/flows/:id/config', (req, res) => {
+        const { id } = req.params;
+        try {
+            const file = fs_1.default.readFileSync(configPath, 'utf8');
+            const allFlowsConfig = JSON.parse(file);
+            const flowConfig = allFlowsConfig[id] || {};
+            res.status(200).send(flowConfig);
+        }
+        catch (error) {
+            console.error('Error reading flow config:', error);
+            res.status(400).send({});
+        }
+    });
+};
+exports.flowsConfigEndpoint = flowsConfigEndpoint;

package/dist/src/flows-endpoint.d.ts

@@ -30,6 +30,7 @@ type FlowStepResponse = {
     bodySchema?: unknown;
     language?: string;
     nodeComponentPath?: string;
+    filePath?: string;
     cronExpression?: string;
 };
 type FlowResponse = FlowListResponse & {

package/dist/src/flows-endpoint.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateFlowsList = exports.flowsEndpoint = void 0;
 const crypto_1 = require("crypto");
 const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
 const guards_1 = require("./guards");
 const get_step_language_1 = require("./get-step-language");
 const flowsEndpoint = (lockedData, app) => {
@@ -36,6 +37,10 @@ const getNodeComponentPath = (filePath) => {
     const tsxPath = filePathWithoutExtension + '.tsx';
     return fs_1.default.existsSync(tsxPath) ? tsxPath : undefined;
 };
+const getRelativePath = (filePath) => {
+    const baseDir = process.cwd();
+    return path_1.default.relative(baseDir, filePath);
+};
 const createEdge = (sourceId, targetId, topic, label, variant, conditional) => ({
     id: `${sourceId}-${targetId}`,
     source: sourceId,
@@ -72,6 +77,7 @@ const createBaseStepResponse = (step, id) => ({
     name: step.config.name,
     description: step.config.description,
     nodeComponentPath: getNodeComponentPath(step.filePath),
+    filePath: getRelativePath(step.filePath),
     language: (0, get_step_language_1.getStepLanguage)(step.filePath),
 });
 const createApiStepResponse = (step, id) => {

package/dist/src/server.js

@@ -16,6 +16,7 @@ const steps_1 = require("./steps");
 const call_step_file_1 = require("./call-step-file");
 const LoggerFactory_1 = require("./LoggerFactory");
 const generate_trace_id_1 = require("./generate-trace-id");
+const flows_config_endpoint_1 = require("./flows-config-endpoint");
 const createServer = async (lockedData, eventManager, state, config) => {
     const printer = lockedData.printer;
     const app = (0, express_1.default)();
@@ -103,6 +104,7 @@ const createServer = async (lockedData, eventManager, state, config) => {
     allSteps.filter(guards_1.isApiStep).forEach(addRoute);
     app.use(router);
     (0, flows_endpoint_1.flowsEndpoint)(lockedData, app);
+    (0, flows_config_endpoint_1.flowsConfigEndpoint)(app, process.cwd());
     server.on('error', (error) => {
         console.error('Server error:', error);
     });

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@motiadev/core",
+  "description": "Core functionality for the Motia framework, providing the foundation for building event-driven workflows.",
   "main": "dist/index.js",
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.6",
   "dependencies": {
     "body-parser": "^1.20.3",
     "colors": "^1.4.0",