paymongo-cli 1.0.0

package/dist/utils/spinner.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ora_1 = __importDefault(require("ora"));
+class Spinner {
+    constructor(options = {}) {
+        const { text = 'Loading...', color = 'cyan' } = options;
+        this.spinner = (0, ora_1.default)({
+            text,
+            color,
+            spinner: 'dots',
+        });
+    }
+    start(text) {
+        if (text) {
+            this.spinner.text = text;
+        }
+        this.spinner.start();
+    }
+    stop() {
+        this.spinner.stop();
+    }
+    succeed(text) {
+        if (text) {
+            this.spinner.text = text;
+        }
+        this.spinner.succeed();
+    }
+    fail(text) {
+        if (text) {
+            this.spinner.text = text;
+        }
+        this.spinner.fail();
+    }
+    warn(text) {
+        if (text) {
+            this.spinner.text = text;
+        }
+        this.spinner.warn();
+    }
+    info(text) {
+        if (text) {
+            this.spinner.text = text;
+        }
+        this.spinner.info();
+    }
+    update(text) {
+        this.spinner.text = text;
+    }
+}
+exports.default = Spinner;
+//# sourceMappingURL=spinner.js.map

package/dist/utils/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/utils/spinner.ts"],"names":[],"mappings":";;;;;AAAA,8CAA+B;AAO/B,MAAM,OAAO;IAGX,YAAY,UAA0B,EAAE;QACtC,MAAM,EAAE,IAAI,GAAG,YAAY,EAAE,KAAK,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;QACxD,IAAI,CAAC,OAAO,GAAG,IAAA,aAAG,EAAC;YACjB,IAAI;YACJ,KAAK;YACL,OAAO,EAAE,MAAM;SAChB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAa;QACjB,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,IAAI;QACF,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,OAAO,CAAC,IAAa;QACnB,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,IAAa;QAChB,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,IAAa;QAChB,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,IAAa;QAChB,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAC3B,CAAC;CACF;AAED,kBAAe,OAAO,CAAC"}

package/dist/utils/validator.d.ts

@@ -0,0 +1,10 @@
+import { PayMongoConfig } from '../types/paymongo';
+export declare class ValidationError extends Error {
+    field?: string | undefined;
+    constructor(message: string, field?: string | undefined);
+}
+export declare function validateApiKey(key: string, type: 'public' | 'secret'): boolean;
+export declare function validateWebhookUrl(url: string): boolean;
+export declare function validateConfig(config: Partial<PayMongoConfig>): void;
+export declare function validateEventTypes(events: string[]): void;
+//# sourceMappingURL=validator.d.ts.map

package/dist/utils/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/utils/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,qBAAa,eAAgB,SAAQ,KAAK;IAG/B,KAAK,CAAC,EAAE,MAAM;gBADrB,OAAO,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,MAAM,YAAA;CAKxB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAW9E;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAWvD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAsCpE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAczD"}

package/dist/utils/validator.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationError = void 0;
+exports.validateApiKey = validateApiKey;
+exports.validateWebhookUrl = validateWebhookUrl;
+exports.validateConfig = validateConfig;
+exports.validateEventTypes = validateEventTypes;
+class ValidationError extends Error {
+    constructor(message, field) {
+        super(message);
+        this.field = field;
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+function validateApiKey(key, type) {
+    if (!key || typeof key !== 'string') {
+        return false;
+    }
+    // PayMongo API keys follow the format: pk_{env}_XXXXXXXXXXXXXXXXXX
+    // where env is 'test' or 'live', and X is alphanumeric characters
+    const prefix = type === 'public' ? 'pk_' : 'sk_';
+    const pattern = new RegExp(`^${prefix}(test|live)_[a-zA-Z0-9]{20,}$`);
+    return pattern.test(key);
+}
+function validateWebhookUrl(url) {
+    try {
+        const parsedUrl = new URL(url);
+        return (parsedUrl.protocol === 'https:' ||
+            parsedUrl.hostname === 'localhost' ||
+            parsedUrl.hostname === '127.0.0.1');
+    }
+    catch {
+        return false;
+    }
+}
+function validateConfig(config) {
+    if (!config.projectName?.trim()) {
+        throw new ValidationError('Project name is required', 'projectName');
+    }
+    if (!config.version) {
+        throw new ValidationError('Config version is required', 'version');
+    }
+    if (!['test', 'live'].includes(config.environment)) {
+        throw new ValidationError('Environment must be either "test" or "live"', 'environment');
+    }
+    const env = config.environment;
+    const apiKeys = config.apiKeys?.[env];
+    if (!apiKeys?.secret) {
+        throw new ValidationError(`Secret API key for ${env} environment is required`, 'apiKeys.secret');
+    }
+    if (apiKeys.public && !validateApiKey(apiKeys.public, 'public')) {
+        throw new ValidationError('Invalid public API key format', 'apiKeys.public');
+    }
+    if (!validateApiKey(apiKeys.secret, 'secret')) {
+        throw new ValidationError('Invalid secret API key format', 'apiKeys.secret');
+    }
+    if (config.webhooks?.url && !validateWebhookUrl(config.webhooks.url)) {
+        throw new ValidationError('Invalid webhook URL. Must be HTTPS or localhost', 'webhooks.url');
+    }
+    if (config.dev?.port !== undefined && (config.dev.port < 1 || config.dev.port > 65535)) {
+        throw new ValidationError('Port must be between 1 and 65535', 'dev.port');
+    }
+}
+function validateEventTypes(events) {
+    const validEvents = [
+        'payment.paid',
+        'payment.failed',
+        'payment.refunded',
+        'source.chargeable',
+        'checkout_session.payment.paid',
+        'qrph.expired',
+    ];
+    const invalidEvents = events.filter((event) => !validEvents.includes(event));
+    if (invalidEvents.length > 0) {
+        throw new ValidationError(`Invalid event types: ${invalidEvents.join(', ')}`);
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/utils/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/utils/validator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "paymongo-cli",
+  "version": "1.0.0",
+  "description": "Developer-first CLI tool for PayMongo integration development with local webhook forwarding, payment testing, and team collaboration features. See USER_GUIDE.md for comprehensive documentation.",
+  "main": "dist/index.js",
+  "bin": {
+    "paymongo": "bin/paymongo.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:incremental": "tsc --incremental",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "lint": "eslint src/**/*.ts tests/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write src/**/*.ts",
+    "benchmark": "npx ts-node scripts/benchmark.ts",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "paymongo",
+    "cli",
+    "payments",
+    "webhooks",
+    "development"
+  ],
+  "author": "Leodyver Semilla",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/leodyversemilla07/paymongo-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/leodyversemilla07/paymongo-cli/issues"
+  },
+  "homepage": "https://github.com/leodyversemilla07/paymongo-cli#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@ngrok/ngrok": "^1.7.0",
+    "@types/express": "^5.0.6",
+    "axios": "^1.6.0",
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "cosmiconfig": "^8.3.6",
+    "express": "^5.2.1",
+    "inquirer": "^9.2.12",
+    "ora": "^7.0.1",
+    "socket.io": "^4.8.3",
+    "winston": "^3.11.0"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.7",
+    "@types/jest": "^29.5.8",
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^6.14.0",
+    "@typescript-eslint/parser": "^6.14.0",
+    "eslint": "^8.55.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.1.1",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.3.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}