@postmate/cli 0.1.0

package/README.md

@@ -0,0 +1 @@
+# postmateli

package/dist/index.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { findPostmateRoot } from './utils/project.js';
+import { CoreContext } from '@postmate/core';
+import { cliLogger } from "./utils/cliLogger.js";
+import fs from "fs";
+import path from "path";
+const program = new Command();
+program
+    .name('pmc')
+    .description('Postmate CLI')
+    .version('0.1.0');
+const runCommand = program
+    .command('run')
+    .description('Run a Postmate collection')
+    .argument('[collection]', 'collection name')
+    .argument('[env]', 'environment name')
+    .argument('[data]', 'data table name')
+    .option('-c, --collection <name>', 'collection name')
+    .option('-e, --env <name>', 'environment name')
+    .option('-d, --data <name>', 'data table name')
+    .action(async (collectionArg, envArg, dataArg, options) => {
+    try {
+        const collection = options.collection ?? collectionArg;
+        const env = options.env ?? envArg;
+        const data = options.data ?? dataArg;
+        if (!collection) {
+            console.error('Error: Collection name is required');
+            process.exit(1);
+        }
+        const baseDir = findPostmateRoot();
+        const coreContext = new CoreContext({
+            baseDir,
+            logger: cliLogger // simple logger for CLI
+        });
+        const runner = coreContext.collectionRunner;
+        let hasFailures = false;
+        const collectionObj = await coreContext.collectionManager.getCollectionByName(collection);
+        if (!collectionObj) {
+            throw new Error(`Collection not found: ${collection}`);
+        }
+        await runner.run({
+            collectionName: collection,
+            containerId: collectionObj.id,
+            requestIds: [],
+            env: env,
+            iterations: 1,
+            delayMs: 0,
+            dataTableName: data
+        }, {
+            onRunStart: (info) => {
+                console.log(`🚀 Running ${info.collectionName}`);
+                console.log(`Env: ${info.env}`);
+                console.log(`Iterations: ${info.iterations}`);
+                console.log(`Total Requests: ${info.totalRequests}`);
+            },
+            onRequestEnd: (info) => {
+                const testResult = info.response.testResult;
+                const statusCode = info.response?.status ?? 0;
+                const passed = statusCode >= 200 && statusCode < 300;
+                const symbol = passed ? '✔' : '✖';
+                console.log(`[Itr. ${info.iteration}] ${info.request.name} [${statusCode}]`);
+                if (testResult?.length)
+                    console.warn('---------------Tests Results-------------');
+                testResult?.forEach(tr => {
+                    let tcPass = tr.status == 'Passed' ? '✔' : '✖';
+                    console.info(`[${tcPass}] ${tr.description} `);
+                });
+                if (!passed) {
+                    hasFailures = true;
+                }
+            },
+            onComplete: (info) => {
+                const seconds = Math.floor(info.durationMs / 1000);
+                console.log(`\nFinished in ${seconds}s`);
+                console.log(`Total Requests: ${info.totalRequests}`);
+                // 1️⃣ Create reports folder
+                const reportsDir = path.join(process.cwd(), "reports");
+                if (!fs.existsSync(reportsDir)) {
+                    fs.mkdirSync(reportsDir, { recursive: true });
+                }
+                // 2️⃣ Generate filename
+                const timestamp = new Date()
+                    .toISOString()
+                    .replace(/:/g, "-");
+                const fileName = `${collection}-${env}-${timestamp}.json`;
+                const filePath = path.join(reportsDir, fileName);
+                // 3️⃣ Write JSON
+                fs.writeFileSync(filePath, JSON.stringify(info.reportJson, null, 2), "utf-8");
+                console.log(`Report saved: ${filePath}`);
+            },
+            onError: (err) => {
+                console.error('Run failed:', err);
+                process.exit(1);
+            }
+        });
+        process.exit(hasFailures ? 1 : 0);
+    }
+    catch (err) {
+        console.error(err.message || err);
+        process.exit(1);
+    }
+});
+program.parse(process.argv);

package/dist/utils/cliLogger.js

@@ -0,0 +1,20 @@
+export const cliLogger = {
+    onRequestStart(info) {
+        console.log(`\n→ ${info.method} ${info.url}`);
+    },
+    onRequestEnd(info) {
+        const status = info.status;
+        const time = info.responseTime;
+        const symbol = status >= 200 && status < 300 ? '✔' : '✖';
+        console.log(`${symbol} ${status} (${time}ms)`);
+    },
+    onScriptLog(msg) {
+        console.log(`   [log] ${msg}`);
+    },
+    onScriptWarn(msg) {
+        console.warn(`   [warn] ${msg}`);
+    },
+    onScriptError(msg) {
+        console.error(`   [error] ${msg}`);
+    }
+};

package/dist/utils/project.js

@@ -0,0 +1,16 @@
+import fs from 'fs';
+import path from 'path';
+export function findPostmateRoot(startDir = process.cwd()) {
+    let current = startDir;
+    while (true) {
+        const candidate = path.join(current, '.postmate');
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            throw new Error('No .postmate directory found');
+        }
+        current = parent;
+    }
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@postmate/cli",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "description": "Postmate CLI - Run API collections from terminal",
+  "main": "dist/index.js",
+  "keywords": [
+    "api",
+    "cli",
+    "testing",
+    "postman-alternative",
+    "automation"
+  ],
+  "author": "Shyam Naryan Yadav",
+  "license": "ISC",
+  "dependencies": {
+    "@postmate/core": "^0.1.15",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.1",
+    "rimraf": "^6.1.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "bin": {
+    "pmc": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "clean": "rimraf dist node_modules package-lock.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "clean": "rimraf dist"
+}