@stackone/cli 1.0.0

package/README.md

@@ -0,0 +1,110 @@
+# StackOne CLI
+
+A command-line interface for StackOne Connect operations.
+
+## Installation
+
+Install globally via npm:
+
+```bash
+npm install -g @stackone/cli
+```
+
+## Usage
+
+After installation, you can use the `stackone` command from anywhere:
+
+```bash
+stackone --help
+stackone -h
+```
+
+## Commands
+
+### `validate`
+
+Validate a StackOne connector file:
+
+```bash
+stackone validate path/to/connector.s1.yaml
+```
+
+Validate multiple connector files at once in a directory (recursive):
+
+```bash
+stackone validate path/to/connectors/
+```
+
+Options:
+
+- `-w or --watch`: Watch for changes in the specified directory of file and validate connectors as they change.
+
+Note: The file extension of a connector file needs to be `.s1.yaml`. The file extension can be omitted.
+
+### `version`
+
+Show CLI version information. If a new version is available, it will prompt you to update:
+
+```bash
+stackone version
+```
+
+### `--version`
+
+Show the current version of the CLI:
+
+```bash
+stackone --version
+stackone -V
+```
+
+### Local Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the package
+npm run build
+
+# Link for global testing
+npm link
+
+# Run tests
+npm test
+
+# Lint and format
+npm run lint:fix
+```
+
+### Building
+
+```bash
+npm run build
+```
+
+### Testing
+
+```bash
+npm test
+```
+
+## Publishing
+
+The package is configured to be published to NPM with public access:
+
+```bash
+npm run publish-release
+```
+
+## Architecture
+
+The CLI is built with:
+
+- **Commander.js** - Command line parsing
+- **Chalk** - Terminal colors and styling
+- **Inquirer** - Interactive prompts
+- **Ora** - Loading spinners
+- **TypeScript** - Type safety
+- **Tsdown** - Bundling
+- **Vitest** - Testing

package/dist/chunk-CUT6urMc.cjs

@@ -0,0 +1,30 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});

package/dist/cli.cjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+const require_cliCore = require('./cliCore-C1gzrk1Q.cjs');
+
+//#region src/cli.ts
+const cli = new require_cliCore.CLI();
+cli.run();
+
+//#endregion

package/dist/cli.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { CLI } from "./cliCore-DKDA_-me.js";
+
+//#region src/cli.ts
+const cli = new CLI();
+cli.run();
+
+//#endregion

package/dist/cliCore-C1gzrk1Q.cjs

@@ -0,0 +1,138 @@
+const require_chunk = require('./chunk-CUT6urMc.cjs');
+const chalk = require_chunk.__toESM(require("chalk"));
+const commander = require_chunk.__toESM(require("commander"));
+const ora = require_chunk.__toESM(require("ora"));
+const fs = require_chunk.__toESM(require("fs"));
+const path = require_chunk.__toESM(require("path"));
+const url = require_chunk.__toESM(require("url"));
+
+//#region src/utils/logger.ts
+var Logger = class {
+	static info(message) {
+		console.info(chalk.default.blue("ℹ"), message);
+	}
+	static warn(message) {
+		console.info(chalk.default.yellow("⚠"), message);
+	}
+	static error(message) {
+		console.info(chalk.default.red("✗"), message);
+	}
+	static success(message) {
+		console.info(chalk.default.green("✓"), message);
+	}
+};
+
+//#endregion
+//#region src/commands/validate.ts
+var ValidateCommand = class {
+	async execute(options) {
+		const { watchMode, fileOrDir } = options;
+		const spinner = (0, ora.default)("Watching for changes...");
+		const displayWatchModeEnabled = () => {
+			console.clear();
+			console.info(chalk.default.yellow("Watch mode enabled. Press \"q\" to quit.\n"));
+		};
+		if (!fileOrDir) return;
+		if (watchMode) {
+			const { watch } = await Promise.resolve().then(() => require("./esm-Chmlhd00.cjs"));
+			const readline = await import("readline");
+			const rl = readline.createInterface({
+				input: process.stdin,
+				output: process.stdout
+			});
+			process.stdin.setRawMode(true);
+			process.stdin.resume();
+			process.stdin.setEncoding("utf8");
+			const cleanup = () => {
+				console.info(chalk.default.grey("\n\nExiting watch mode..."));
+				watcher.close();
+				spinner.stop();
+				rl.close();
+				process.exit(0);
+			};
+			displayWatchModeEnabled();
+			console.info(chalk.default.blue(`Running connector(s) validations...`));
+			await validateConnector(fileOrDir);
+			spinner.start();
+			const watcher = watch(fileOrDir || ".", {
+				ignored: /(^|[/\\])\../,
+				persistent: true
+			});
+			watcher.on("change", async (path$1) => {
+				displayWatchModeEnabled();
+				spinner.stop();
+				console.info(chalk.default.blue(`File change detected. Running connector(s) validations...`));
+				await validateConnector(fileOrDir);
+				spinner.start();
+			});
+			process.stdin.on("data", (key) => {
+				if (key.toString() === "q") cleanup();
+			});
+			process.on("SIGINT", () => {
+				cleanup();
+			});
+		} else await validateConnector(fileOrDir);
+	}
+};
+const validateConnector = async (path$1) => {
+	await new Promise((resolve) => setTimeout(resolve, 2e3));
+	Logger.success(`Connector ${path$1} is valid!\n`);
+};
+
+//#endregion
+//#region src/utils/packageVersion.ts
+const getPackageVersion = () => {
+	try {
+		const __filename$1 = (0, url.fileURLToPath)(require("url").pathToFileURL(__filename).href);
+		const __dirname$1 = (0, path.dirname)(__filename$1);
+		const packageJsonPath = (0, path.join)(__dirname$1, "..", "package.json");
+		const packageJson = JSON.parse((0, fs.readFileSync)(packageJsonPath, "utf8"));
+		return packageJson.version;
+	} catch {
+		return "unknown";
+	}
+};
+
+//#endregion
+//#region src/cliCore.ts
+var CLI = class {
+	constructor(program = new commander.Command(), version = getPackageVersion()) {
+		this.program = program;
+		this.version = version;
+		this.setupProgram();
+		this.registerCommands();
+	}
+	setupProgram() {
+		this.program.name("stackone").description("StackOne Connect CLI tool").version(this.version);
+	}
+	registerCommands() {
+		const validateCommand = new ValidateCommand();
+		this.program.configureOutput({
+			writeOut: (str) => process.stdout.write(str),
+			writeErr: (str) => process.stderr.write(str),
+			outputError: (str, write) => {
+				write(chalk.default.red(str));
+			}
+		});
+		this.program.command("validate").option("-w, --watch", "Run in watch mode").addArgument(new commander.Argument("<path>", "Connector file or directory with connectors to validate")).description("Validate a StackOne connector").action((fileOrDir, options) => {
+			validateCommand.execute({
+				watchMode: options.watch,
+				fileOrDir
+			});
+		});
+		this.program.command("version").description("Show version information").action(() => {
+			console.info(`${chalk.default.greenBright("StackOne")} ${chalk.default.grey("CLI")} ${chalk.default.whiteBright(this.version)}`);
+		});
+	}
+	run() {
+		this.program.parse(process.argv);
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'CLI', {
+  enumerable: true,
+  get: function () {
+    return CLI;
+  }
+});

package/dist/cliCore-DKDA_-me.js

@@ -0,0 +1,132 @@
+import chalk from "chalk";
+import { Argument, Command } from "commander";
+import ora from "ora";
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+
+//#region src/utils/logger.ts
+var Logger = class {
+	static info(message) {
+		console.info(chalk.blue("ℹ"), message);
+	}
+	static warn(message) {
+		console.info(chalk.yellow("⚠"), message);
+	}
+	static error(message) {
+		console.info(chalk.red("✗"), message);
+	}
+	static success(message) {
+		console.info(chalk.green("✓"), message);
+	}
+};
+
+//#endregion
+//#region src/commands/validate.ts
+var ValidateCommand = class {
+	async execute(options) {
+		const { watchMode, fileOrDir } = options;
+		const spinner = ora("Watching for changes...");
+		const displayWatchModeEnabled = () => {
+			console.clear();
+			console.info(chalk.yellow("Watch mode enabled. Press \"q\" to quit.\n"));
+		};
+		if (!fileOrDir) return;
+		if (watchMode) {
+			const { watch: watch$1 } = await import("./esm-BenXeAeS.js");
+			const readline = await import("readline");
+			const rl = readline.createInterface({
+				input: process.stdin,
+				output: process.stdout
+			});
+			process.stdin.setRawMode(true);
+			process.stdin.resume();
+			process.stdin.setEncoding("utf8");
+			const cleanup = () => {
+				console.info(chalk.grey("\n\nExiting watch mode..."));
+				watcher.close();
+				spinner.stop();
+				rl.close();
+				process.exit(0);
+			};
+			displayWatchModeEnabled();
+			console.info(chalk.blue(`Running connector(s) validations...`));
+			await validateConnector(fileOrDir);
+			spinner.start();
+			const watcher = watch$1(fileOrDir || ".", {
+				ignored: /(^|[/\\])\../,
+				persistent: true
+			});
+			watcher.on("change", async (path) => {
+				displayWatchModeEnabled();
+				spinner.stop();
+				console.info(chalk.blue(`File change detected. Running connector(s) validations...`));
+				await validateConnector(fileOrDir);
+				spinner.start();
+			});
+			process.stdin.on("data", (key) => {
+				if (key.toString() === "q") cleanup();
+			});
+			process.on("SIGINT", () => {
+				cleanup();
+			});
+		} else await validateConnector(fileOrDir);
+	}
+};
+const validateConnector = async (path) => {
+	await new Promise((resolve) => setTimeout(resolve, 2e3));
+	Logger.success(`Connector ${path} is valid!\n`);
+};
+
+//#endregion
+//#region src/utils/packageVersion.ts
+const getPackageVersion = () => {
+	try {
+		const __filename = fileURLToPath(import.meta.url);
+		const __dirname = dirname(__filename);
+		const packageJsonPath = join(__dirname, "..", "package.json");
+		const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+		return packageJson.version;
+	} catch {
+		return "unknown";
+	}
+};
+
+//#endregion
+//#region src/cliCore.ts
+var CLI = class {
+	constructor(program = new Command(), version = getPackageVersion()) {
+		this.program = program;
+		this.version = version;
+		this.setupProgram();
+		this.registerCommands();
+	}
+	setupProgram() {
+		this.program.name("stackone").description("StackOne Connect CLI tool").version(this.version);
+	}
+	registerCommands() {
+		const validateCommand = new ValidateCommand();
+		this.program.configureOutput({
+			writeOut: (str) => process.stdout.write(str),
+			writeErr: (str) => process.stderr.write(str),
+			outputError: (str, write) => {
+				write(chalk.red(str));
+			}
+		});
+		this.program.command("validate").option("-w, --watch", "Run in watch mode").addArgument(new Argument("<path>", "Connector file or directory with connectors to validate")).description("Validate a StackOne connector").action((fileOrDir, options) => {
+			validateCommand.execute({
+				watchMode: options.watch,
+				fileOrDir
+			});
+		});
+		this.program.command("version").description("Show version information").action(() => {
+			console.info(`${chalk.greenBright("StackOne")} ${chalk.grey("CLI")} ${chalk.whiteBright(this.version)}`);
+		});
+	}
+	run() {
+		this.program.parse(process.argv);
+	}
+};
+
+//#endregion
+export { CLI };