postman-cli 0.0.0-alpha.0 → 1.19.4

package/README.md

@@ -0,0 +1,79 @@
+<br>
+
+<div align="left">
+  <a href="https://www.getpostman.com/">
+    <img src="https://voyager.postman.com/logo/postman-logo-orange.svg" alt="Postman Logo" width="400" height="200">
+  </a>
+</div>
+
+<br>
+
+# Postman CLI
+
+The Postman CLI brings the power of Postman’s API platform directly to your terminal. It lets you run collections, automate tests, integrate API checks into CI/CD pipelines, and enforce quality gates — all with a single, lightweight command-line tool. Whether you’re debugging locally, scaling systems, or embedding API workflows into your build system, the Postman CLI helps you bridge the gap between collaborative API design in Postman and automated execution in your development and production environments.
+
+## Installation
+
+### npm
+
+```bash
+npm install -g postman-cli
+```
+
+### Alternative Installation Methods
+
+For direct binary downloads, platform-specific installers, or other installation methods, see the **[Installation Guide](https://learning.postman.com/docs/postman-cli/postman-cli-installation/)**.
+
+## Usage
+
+```bash
+# Get help
+postman --help
+
+# Sign in to Postman
+postman login
+
+# Sign in to Postman and EU region
+postman login --region eu
+
+# Sign in using API key
+postman login --with-api-key <api-key>
+
+# Sign in using API key and EU region
+postman login --with-api-key <api-key> --region eu
+
+# Run a collection
+postman collection run <collection-id>
+
+# Run with environment
+postman collection run <collection-id> -e <environment-id>
+
+# Run a monitor
+postman monitor run <monitor-id>
+
+# Check API governance and security rules
+postman api lint <api-id>
+```
+
+## Platform Support
+
+This package automatically downloads the appropriate binary for your platform:
+
+- macOS (Intel & Apple Silicon)
+- Linux (x64)
+- Windows (x64)
+
+> **Note:** Linux support excludes Alpine Linux distributions due to libc compatibility requirements.
+For Alpine environments, consider using alternative installation methods or running from a glibc-based base image.
+
+## Resources
+
+- **[Complete Documentation](https://learning.postman.com/docs/postman-cli/postman-cli-overview/)** - Full guide with examples and advanced usage
+- **[Installation Guide](https://learning.postman.com/docs/postman-cli/postman-cli-installation/)** - All installation methods and platform-specific instructions
+- **[Command Reference](https://learning.postman.com/docs/postman-cli/postman-cli-options/)** - Complete list of commands and options
+- **[Release Notes](https://www.postman.com/release-notes/postman-cli/)** - Latest versions and changelog
+
+## Support
+
+- [Postman Support](https://support.postman.com/) – For general support and troubleshooting
+- [GitHub Issues](https://github.com/postmanlabs/postman-app-support/issues) – For bug reports and feature requests

package/bin/postman.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+const run = require('../index');
+
+try {
+    run(...process.argv.slice(2));
+}
+catch (error) {
+    process.exit(1);
+}

package/index.js

@@ -0,0 +1,37 @@
+const { execFileSync } = require('child_process'),
+
+    PLATFORM_PACKAGES = {
+        'darwin-arm64': 'pm-bin-macos-arm64',
+        'darwin-x64': 'pm-bin-macos-x64',
+        'win32-x64': 'pm-bin-windows-x64',
+        'linux-x64': 'pm-bin-linux-x64'
+    };
+
+function locateBinary () {
+    const platformKey = `${process.platform}-${process.arch}`,
+        packageName = PLATFORM_PACKAGES[platformKey];
+
+    if (!packageName) {
+        throw new Error(`Unsupported platform: ${platformKey}`);
+    }
+
+    // eslint-disable-next-line one-var
+    const binaryName = process.platform === 'win32' ? 'postman.exe' : 'postman';
+
+    try {
+        return require.resolve(`@postman/${packageName}/bin/${binaryName}`);
+    }
+    catch (error) {
+        throw new Error(
+            `Binary not found for ${platformKey}. ` +
+            `Make sure @postman/${packageName} is installed. `
+        );
+    }
+}
+
+module.exports = function run (...args) {
+    return execFileSync(locateBinary(), args, {
+        stdio: 'inherit',
+        encoding: 'utf8'
+    });
+};

package/package.json

@@ -1,11 +1,64 @@
 {
   "name": "postman-cli",
-  "version": "0.0.0-alpha.0",
-  "description": "",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "version": "1.19.4",
+  "description": "Official Postman CLI - Command-line companion for API development, testing, and automation",
+  "keywords": [
+    "postman",
+    "cli",
+    "api",
+    "testing",
+    "automation",
+    "rest",
+    "newman",
+    "api-testing",
+    "api-development",
+    "ci-cd",
+    "continuous-integration",
+    "postman-cli",
+    "api-client",
+    "http-client",
+    "api-automation",
+    "collection-runner",
+    "postman-collection",
+    "api-governance",
+    "api-security",
+    "api-linting",
+    "api-validation",
+    "contract-testing",
+    "schema-validation",
+    "devops",
+    "pipeline",
+    "github-actions",
+    "gitlab-ci",
+    "azure-devops",
+    "jenkins",
+    "circleci",
+    "integration-testing",
+    "functional-testing",
+    "test-reports",
+    "junit-reports",
+    "html-reports",
+    "postman-automation",
+    "postman-testing",
+    "postman-runner",
+    "postman-monitor",
+    "rest-api",
+    "http-testing",
+    "api-tools"
+  ],
+  "bin": {
+    "postman": "bin/postman.js"
   },
-  "author": "Shamasis Bhattacharya <mail@shamasis.net> (=)",
-  "license": "Apache-2.0"
+  "files": [
+    "bin/",
+    "index.js",
+    "package.json",
+    "README.md"
+  ],
+  "optionalDependencies": {
+    "@postman/pm-bin-macos-arm64": "1.19.4",
+    "@postman/pm-bin-macos-x64": "1.19.4",
+    "@postman/pm-bin-linux-x64": "1.19.4",
+    "@postman/pm-bin-windows-x64": "1.19.4"
+  }
 }