@walkeros/cli 0.4.2 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @walkeros/cli
 
+## 0.5.0
+
+### Minor Changes
+
+- just flow
+
+### Patch Changes
+
+- Updated dependencies
+  - @walkeros/core@0.5.0
+  - @walkeros/docker@0.3.0
+  - @walkeros/server-core@0.5.0
+
 ## 0.4.2
 
 ### Patch Changes

package/README.md

@@ -24,6 +24,22 @@ npm install -g @walkeros/cli
 npm install @walkeros/cli
 ```
 
+## Quick Start
+
+```bash
+# Bundle a flow configuration
+walkeros bundle flow.json
+
+# Test with simulated events (no real API calls)
+walkeros simulate flow.json --event '{"name":"page view"}'
+
+# Push real events to destinations
+walkeros push flow.json --event '{"name":"page view"}'
+
+# Run a collection server locally
+walkeros run collect flow.json --port 3000
+```
+
 ## Commands
 
 ### bundle
@@ -86,6 +102,49 @@ walkeros simulate \
   --json
 ```
 
+### push
+
+Execute your flow with real API calls to configured destinations. Unlike
+`simulate` which mocks API calls, `push` performs actual HTTP requests.
+
+```bash
+walkeros push <config-file> --event '<json>' [options]
+```
+
+**Options:**
+
+- `-e, --event <source>` - Event to push (JSON string, file path, or URL)
+  **Required**
+- `--flow <name>` - Flow name (for multi-flow configs)
+- `--json` - Output results as JSON
+- `-v, --verbose` - Verbose output
+- `-s, --silent` - Suppress output (for CI/CD)
+- `--local` - Execute locally without Docker
+
+**Event input formats:**
+
+```bash
+# Inline JSON
+walkeros push flow.json --event '{"name":"page view","data":{"title":"Home"}}'
+
+# File path
+walkeros push flow.json --event ./events/order.json
+
+# URL
+walkeros push flow.json --event https://example.com/sample-event.json
+```
+
+**Push vs Simulate:**
+
+| Feature      | `push`                              | `simulate`         |
+| ------------ | ----------------------------------- | ------------------ |
+| API Calls    | Real HTTP requests                  | Mocked (captured)  |
+| Use Case     | Integration testing                 | Safe local testing |
+| Side Effects | Full (writes to DBs, sends to APIs) | None               |
+
+Use `simulate` first to validate configuration safely, then `push` to verify
+real integrations.
+
 ### run
 
 Run flows locally using @walkeros/docker as a library (no Docker daemon
@@ -176,12 +235,12 @@ Flow configs use the `Flow.Setup` format with `version` and `flows`:
       "server": {},
       "packages": {
         "@walkeros/collector": { "imports": ["startFlow"] },
-        "@walkeros/server-source-express": { "imports": ["sourceExpress"] },
-        "@walkeros/destination-demo": { "imports": ["destinationDemo"] }
+        "@walkeros/server-source-express": {},
+        "@walkeros/destination-demo": {}
       },
       "sources": {
         "http": {
-          "code": "sourceExpress",
+          "package": "@walkeros/server-source-express",
           "config": {
             "settings": { "path": "/collect", "port": 8080 }
           }
@@ -189,7 +248,7 @@ Flow configs use the `Flow.Setup` format with `version` and `flows`:
       },
       "destinations": {
         "demo": {
-          "code": "destinationDemo",
+          "package": "@walkeros/destination-demo",
           "config": {
             "settings": { "name": "Demo" }
           }
@@ -203,6 +262,76 @@ Flow configs use the `Flow.Setup` format with `version` and `flows`:
 
 Platform is determined by the `web: {}` or `server: {}` key presence.
 
+### Package Configuration Patterns
+
+The CLI automatically resolves imports based on how you configure packages:
+
+**1. Default exports (recommended for single-export packages):**
+
+```json
+{
+  "packages": {
+    "@walkeros/server-destination-api": {}
+  },
+  "destinations": {
+    "api": {
+      "package": "@walkeros/server-destination-api"
+    }
+  }
+}
+```
+
+The CLI generates:
+`import _walkerosServerDestinationApi from '@walkeros/server-destination-api';`
+
+**2. Named exports (for multi-export packages):**
+
+```json
+{
+  "packages": {
+    "@walkeros/server-destination-gcp": {}
+  },
+  "destinations": {
+    "bigquery": {
+      "package": "@walkeros/server-destination-gcp",
+      "code": "destinationBigQuery"
+    },
+    "analytics": {
+      "package": "@walkeros/server-destination-gcp",
+      "code": "destinationAnalytics"
+    }
+  }
+}
+```
+
+The CLI generates:
+`import { destinationBigQuery, destinationAnalytics } from '@walkeros/server-destination-gcp';`
+
+**3. Utility imports (for helper functions):**
+
+```json
+{
+  "packages": {
+    "lodash": { "imports": ["get", "set"] }
+  },
+  "mappings": {
+    "custom": {
+      "data": "({ data }) => get(data, 'user.email')"
+    }
+  }
+}
+```
+
+The CLI generates: `import { get, set } from 'lodash';`
+
+**Key points:**
+
+- Omit `packages.imports` for destinations/sources - the default export is used
+  automatically
+- Only specify `code` when using a specific named export from a multi-export
+  package
+- Use `packages.imports` only for utilities needed in mappings or custom code
+
 ### Local Packages
 
 Use local packages instead of npm for development or testing unpublished
@@ -364,13 +493,15 @@ walkeros bundle config.json
 - **Node.js**: 18+ or 22+
 - **Docker**: Not required for CLI (only for production deployment)
 
-## Documentation
+## Type Definitions
+
+See [src/types.ts](./src/types.ts) for TypeScript interfaces.
 
-Detailed guides in [docs/](./docs/):
+## Related
 
-- [RUN_COMMAND.md](./docs/RUN_COMMAND.md) - Run command details
-- [PUBLISHING.md](./docs/PUBLISHING.md) - Publishing guide
-- [MANUAL_TESTING_GUIDE.md](./docs/MANUAL_TESTING_GUIDE.md) - Testing guide
+- [Website Documentation](https://www.walkeros.io/docs/cli/)
+- [Flow Configuration](https://www.walkeros.io/docs/getting-started/flow/)
+- [Docker Package](../docker/) - Production runtime
 
 ## License
 

package/dist/__tests__/bundle/bundler-helpers.test.js

@@ -110,139 +110,6 @@ describe('Bundler Helper Functions', () => {
             expect(packages).toBeDefined();
         });
     });
-    describe('processTemplate', () => {
-        it('should return code directly when no template', async () => {
-            const flowConfig = {};
-            const buildOptions = {
-                code: 'console.log("test");',
-                template: undefined,
-            };
-            // Expected: returns code as-is
-            expect(buildOptions.template).toBeUndefined();
-            expect(buildOptions.code).toBe('console.log("test");');
-        });
-        it('should process template when configured', async () => {
-            const flowConfig = {
-                sources: {},
-                destinations: {},
-                collector: {},
-            };
-            const buildOptions = {
-                code: 'custom code',
-                template: 'flow-template',
-            };
-            // Expected: calls TemplateEngine.process with all parameters
-            expect(buildOptions.template).toBe('flow-template');
-        });
-        it('should handle empty code', async () => {
-            const flowConfig = {};
-            const buildOptions = {
-                code: undefined,
-                template: undefined,
-            };
-            // Expected: returns empty string
-            expect(buildOptions.code).toBeUndefined();
-        });
-    });
-    describe('wrapCodeForFormat', () => {
-        it('should not wrap code when template is used', () => {
-            const code = 'const flow = startFlow();';
-            const format = 'esm';
-            const hasTemplate = true;
-            // Expected: returns code as-is
-            expect(hasTemplate).toBe(true);
-        });
-        it('should wrap ESM code without exports', () => {
-            const code = 'const flow = startFlow();';
-            const format = 'esm';
-            const hasTemplate = false;
-            // Expected: export default const flow = startFlow();
-            expect(format).toBe('esm');
-            expect(hasTemplate).toBe(false);
-            expect(code).not.toMatch(/^\s*export\s/m);
-        });
-        it('should not wrap ESM code that already has exports', () => {
-            const code = 'export const flow = startFlow();';
-            const format = 'esm';
-            const hasTemplate = false;
-            // Expected: returns code as-is (already has export)
-            expect(code).toMatch(/^\s*export\s/m);
-        });
-        it('should not wrap non-ESM formats', () => {
-            const code = 'const flow = startFlow();';
-            const format = 'cjs';
-            const hasTemplate = false;
-            // Expected: returns code as-is
-            expect(format).toBe('cjs');
-        });
-        it('should not wrap IIFE format', () => {
-            const code = 'const flow = startFlow();';
-            const format = 'iife';
-            const hasTemplate = false;
-            // Expected: returns code as-is
-            expect(format).toBe('iife');
-        });
-    });
-    describe('assembleFinalCode', () => {
-        it('should combine imports, examples, and code', () => {
-            const importStatements = [
-                "import { getId } from '@walkeros/core';",
-                "import { startFlow } from '@walkeros/collector';",
-            ];
-            const examplesObject = 'const examples = {\n  gtag: gtag_examples\n};\n\n';
-            const wrappedCode = 'export default startFlow();';
-            const format = 'esm';
-            // Expected: imports + examples + code
-            expect(importStatements).toHaveLength(2);
-            expect(examplesObject).toContain('const examples');
-            expect(wrappedCode).toContain('export default');
-        });
-        it('should handle empty imports', () => {
-            const importStatements = [];
-            const examplesObject = '';
-            const wrappedCode = 'export default startFlow();';
-            const format = 'esm';
-            // Expected: just the code
-            expect(importStatements).toHaveLength(0);
-        });
-        it('should add examples export for ESM with examples', () => {
-            const importStatements = ["import { getId } from '@walkeros/core';"];
-            const examplesObject = 'const examples = {\n  gtag: gtag_examples\n};\n\n';
-            const wrappedCode = 'export default startFlow();';
-            const format = 'esm';
-            // Expected to include: export { examples };
-            expect(format).toBe('esm');
-            expect(examplesObject).toContain('const examples');
-        });
-        it('should not add examples export for non-ESM formats', () => {
-            const importStatements = ["import { getId } from '@walkeros/core';"];
-            const examplesObject = 'const examples = {\n  gtag: gtag_examples\n};\n\n';
-            const wrappedCode = 'startFlow();';
-            const format = 'cjs';
-            // Should not include: export { examples };
-            expect(format).not.toBe('esm');
-        });
-        it('should not add examples export when no examples', () => {
-            const importStatements = ["import { getId } from '@walkeros/core';"];
-            const examplesObject = '';
-            const wrappedCode = 'export default startFlow();';
-            const format = 'esm';
-            // Should not include: export { examples };
-            expect(examplesObject).toBe('');
-        });
-        it('should handle multiple import statements', () => {
-            const importStatements = [
-                "import walkerCore from '@walkeros/core';",
-                "import { getId, trim } from '@walkeros/core';",
-                "import { startFlow } from '@walkeros/collector';",
-            ];
-            const examplesObject = '';
-            const wrappedCode = 'export default startFlow();';
-            const format = 'esm';
-            // Expected: all imports joined with newlines
-            expect(importStatements).toHaveLength(3);
-        });
-    });
     describe('Integration: createEntryPoint refactored behavior', () => {
         it('should maintain backward compatibility with original implementation', () => {
             // This test documents that the refactored version should produce
@@ -265,7 +132,6 @@ describe('Bundler Helper Functions', () => {
                     },
                 },
                 code: 'export const flow = startFlow();',
-                template: undefined,
                 format: 'esm',
                 platform: 'browser',
             };

package/dist/__tests__/bundle/bundler-helpers.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"bundler-helpers.test.js","sourceRoot":"","sources":["../../../src/__tests__/bundle/bundler-helpers.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bundler-helpers.test.js","sourceRoot":"","sources":["../../../src/__tests__/bundle/bundler-helpers.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/bundle/bundler.test.js

@@ -1,6 +1,6 @@
 import fs from 'fs-extra';
 import path from 'path';
-import { bundleCore as bundle } from '../../commands/bundle/bundler.js';
+import { bundleCore as bundle, buildConfigObject, generatePlatformWrapper, createEntryPoint, } from '../../commands/bundle/bundler.js';
 import { loadBundleConfig } from '../../config/index.js';
 import { createLogger } from '../../core/index.js';
 import { getId } from '@walkeros/core';
@@ -77,7 +77,6 @@ describe('Bundler', () => {
         const buildOptions = createBuildOptions({
             packages: flowConfig.packages || {},
             code: 'export const test = getId(8);',
-            template: '',
             platform: 'browser',
             format: 'esm',
             output: path.join(testOutputDir, 'minimal.js'),
@@ -96,7 +95,6 @@ describe('Bundler', () => {
         const buildOptions = createBuildOptions({
             packages: flowConfig.packages || {},
             code: 'export default { processText: (text) => trim(text) };',
-            template: '',
             platform: 'node',
             format: 'esm',
             output: path.join(testOutputDir, 'server-bundle.mjs'),
@@ -115,7 +113,6 @@ describe('Bundler', () => {
         const buildOptions = createBuildOptions({
             packages: flowConfig.packages || {},
             code: "export function processData(data) {\n  return data.map(item => ({\n    ...item,\n    id: getId(8),\n    timestamp: new Date().toISOString().split('T')[0],\n    processed: true\n  }));\n}\n\nexport function extractNestedValues(data, path) {\n  return data.map(item => getByPath(item, path, null)).filter(val => val !== null);\n}\n\nexport function deepCloneData(data) {\n  return clone(data);\n}\n\nexport function cleanStringData(data) {\n  return data.map(item => ({\n    ...item,\n    name: typeof item.name === 'string' ? trim(item.name) : item.name\n  }));\n}\n\n// Re-export walkerOS utilities\nexport { getId, getByPath, clone, trim, isObject };",
-            template: '',
             platform: 'browser',
             format: 'esm',
             target: 'es2020',
@@ -138,7 +135,6 @@ describe('Bundler', () => {
             const buildOptions = createBuildOptions({
                 packages: flowConfig.packages || {},
                 code: 'export const test = getId(8);',
-                template: '',
                 format: 'esm',
                 output: path.join(testOutputDir, 'stats-test.js'),
             });
@@ -158,7 +154,6 @@ describe('Bundler', () => {
             const buildOptions = createBuildOptions({
                 packages: flowConfig.packages || {},
                 code: 'import * as walkerCore from "@walkeros/core";\nexport const test = walkerCore.getId;',
-                template: '',
                 format: 'esm',
                 output: path.join(testOutputDir, 'test.js'),
             });
@@ -177,7 +172,6 @@ describe('Bundler', () => {
             const buildOptions = createBuildOptions({
                 packages: flowConfig.packages || {},
                 code: 'export const test = getId(8);',
-                template: '',
                 format: 'esm',
                 output: path.join(testOutputDir, 'no-stats.js'),
             });
@@ -185,58 +179,6 @@ describe('Bundler', () => {
             expect(result).toBeUndefined();
         });
     });
-    describe('Template System', () => {
-        it('should handle template configuration', async () => {
-            // Create a test template file
-            const templatePath = path.join(testOutputDir, 'test.hbs');
-            await fs.writeFile(templatePath, '{{{CODE}}}\n// Template footer');
-            const flowConfig = {
-                web: {},
-                packages: {
-                    '@walkeros/core': { imports: ['getId'] },
-                },
-            };
-            const buildOptions = createBuildOptions({
-                packages: flowConfig.packages || {},
-                code: 'export const generateId = () => getId(8);',
-                template: templatePath,
-                output: path.join(testOutputDir, 'template-test.js'),
-            });
-            await expect(bundle(flowConfig, buildOptions, logger)).resolves.not.toThrow();
-        });
-        it('should handle missing template variables gracefully', async () => {
-            const flowConfig = {
-                web: {},
-                packages: {
-                    '@walkeros/core': { imports: ['trim'] },
-                },
-            };
-            const buildOptions = createBuildOptions({
-                packages: flowConfig.packages || {},
-                code: 'export const test = trim("hello");',
-                template: '',
-                format: 'esm',
-                output: path.join(testOutputDir, 'missing-vars.js'),
-            });
-            await expect(bundle(flowConfig, buildOptions, logger)).resolves.not.toThrow();
-        });
-        it('should append bundle code when placeholder not found', async () => {
-            const flowConfig = {
-                web: {},
-                packages: {
-                    '@walkeros/core': { imports: ['getId'] },
-                },
-            };
-            const buildOptions = createBuildOptions({
-                packages: flowConfig.packages || {},
-                code: 'export const test = getId(6);',
-                template: '',
-                format: 'esm',
-                output: path.join(testOutputDir, 'append-test.js'),
-            });
-            await expect(bundle(flowConfig, buildOptions, logger)).resolves.not.toThrow();
-        });
-    });
     describe('Configuration Scenarios', () => {
         it('should handle custom temp directory configuration', async () => {
             const flowConfig = {
@@ -248,7 +190,6 @@ describe('Bundler', () => {
             const buildOptions = createBuildOptions({
                 packages: flowConfig.packages || {},
                 code: 'export const test = getId();',
-                template: '',
                 format: 'esm',
                 tempDir: '/tmp/my-custom-bundler-temp',
                 output: path.join(testOutputDir, 'custom-temp-example.js'),
@@ -265,7 +206,6 @@ describe('Bundler', () => {
             const buildOptions = createBuildOptions({
                 packages: flowConfig.packages || {},
                 code: '// Test version pinning\nexport const test = getId();',
-                template: '',
                 platform: 'browser',
                 format: 'esm',
                 target: 'es2020',
@@ -289,5 +229,125 @@ describe('Bundler', () => {
             }).toThrow(/Invalid configuration/);
         });
     });
+    describe('buildConfigObject', () => {
+        it('uses explicit code for named imports', () => {
+            const flowConfig = {
+                server: {},
+                sources: {
+                    http: {
+                        package: '@walkeros/server-source-express',
+                        code: 'sourceExpress',
+                        config: { settings: { port: 8080 } },
+                    },
+                },
+                destinations: {
+                    demo: {
+                        package: '@walkeros/destination-demo',
+                        code: 'destinationDemo',
+                        config: { settings: { name: 'Test' } },
+                    },
+                },
+            };
+            const explicitCodeImports = new Map([
+                ['@walkeros/server-source-express', new Set(['sourceExpress'])],
+                ['@walkeros/destination-demo', new Set(['destinationDemo'])],
+            ]);
+            const result = buildConfigObject(flowConfig, explicitCodeImports);
+            expect(result).toContain('code: sourceExpress');
+            expect(result).toContain('code: destinationDemo');
+            expect(result).toContain('"port": 8080');
+            expect(result).toContain('"name": "Test"');
+        });
+        it('uses default import variable when no explicit code', () => {
+            const flowConfig = {
+                server: {},
+                sources: {
+                    http: {
+                        package: '@walkeros/server-source-express',
+                        config: { settings: { port: 8080 } },
+                    },
+                },
+                destinations: {},
+            };
+            const explicitCodeImports = new Map(); // No explicit imports
+            const result = buildConfigObject(flowConfig, explicitCodeImports);
+            expect(result).toContain('code: _walkerosServerSourceExpress');
+        });
+    });
+    describe('generatePlatformWrapper', () => {
+        it('generates web IIFE wrapper', () => {
+            const config = '{ sources: {}, destinations: {} }';
+            const userCode = 'console.log("custom code");';
+            const buildOptions = {
+                platform: 'browser',
+                windowCollector: 'collector',
+                windowElb: 'elb',
+            };
+            const result = generatePlatformWrapper(config, userCode, buildOptions);
+            expect(result).toContain('(async () => {');
+            expect(result).toContain('const config = { sources: {}, destinations: {} };');
+            expect(result).toContain('console.log("custom code");');
+            expect(result).toContain('await startFlow(config)');
+            expect(result).toContain("window['collector'] = collector");
+            expect(result).toContain("window['elb'] = elb");
+        });
+        it('generates server export default wrapper', () => {
+            const config = '{ sources: {}, destinations: {} }';
+            const userCode = '';
+            const buildOptions = { platform: 'node' };
+            const result = generatePlatformWrapper(config, userCode, buildOptions);
+            expect(result).toContain('export default async function');
+            expect(result).toContain('const config = { sources: {}, destinations: {} };');
+            expect(result).toContain('return await startFlow(config)');
+            expect(result).not.toContain('window');
+        });
+    });
+    describe('createEntryPoint integration', () => {
+        it('generates complete entry point with explicit code', async () => {
+            const flowConfig = {
+                server: {},
+                packages: {
+                    '@walkeros/collector': { imports: ['startFlow'] },
+                    '@walkeros/server-source-express': {},
+                    '@walkeros/destination-demo': {},
+                },
+                sources: {
+                    http: {
+                        package: '@walkeros/server-source-express',
+                        code: 'sourceExpress',
+                        config: { settings: { port: 8080 } },
+                    },
+                },
+                destinations: {
+                    demo: {
+                        package: '@walkeros/destination-demo',
+                        code: 'destinationDemo',
+                        config: { settings: { name: 'Test' } },
+                    },
+                },
+            };
+            const buildOptions = {
+                platform: 'node',
+                format: 'esm',
+                packages: {
+                    '@walkeros/collector': { imports: ['startFlow'] },
+                    '@walkeros/server-source-express': {},
+                    '@walkeros/destination-demo': {},
+                },
+                output: './dist/bundle.mjs',
+                code: '',
+            };
+            const result = await createEntryPoint(flowConfig, buildOptions, new Map());
+            // Should have named imports
+            expect(result).toContain("import { startFlow } from '@walkeros/collector'");
+            expect(result).toContain("import { sourceExpress } from '@walkeros/server-source-express'");
+            expect(result).toContain("import { destinationDemo } from '@walkeros/destination-demo'");
+            // Should use those imports in config
+            expect(result).toContain('code: sourceExpress');
+            expect(result).toContain('code: destinationDemo');
+            // Should have server wrapper
+            expect(result).toContain('export default async function');
+        });
+    });
 });
 //# sourceMappingURL=bundler.test.js.map