@kristijorgji/cli-kit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kristijorgji
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,24 @@
+# @kristijorgji/cli-kit
+
+Shared CLI primitives for `@kristijorgji` tooling: a pino-pretty logger, a table printer, and a `spawnSync` wrapper.
+
+## Install
+
+```bash
+pnpm add -D @kristijorgji/cli-kit
+```
+
+## Usage
+
+```ts
+import { cliLogger, cliTable, logFatalAndExit, runCommand } from '@kristijorgji/cli-kit';
+
+cliLogger.info('starting');
+cliTable([{ Name: 'framework', SizeKB: 58 }]);
+runCommand('pnpm', ['exec', 'size-limit'], { cwd: process.cwd() });
+logFatalAndExit('unrecoverable');
+```
+
+## License
+
+MIT

package/dist/cli-logger.d.ts

@@ -0,0 +1,8 @@
+import type { Logger } from 'pino';
+import 'pino-pretty';
+export declare function createCliLogger(level?: string): Logger;
+/** Default logger for scripts that do not load a custom log level from env. */
+export declare const cliLogger: Logger;
+export declare function logFatalAndExit(msg: string): never;
+export declare function logFatalAndExitFromError(err: unknown): never;
+//# sourceMappingURL=cli-logger.d.ts.map

package/dist/cli-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-logger.d.ts","sourceRoot":"","sources":["../src/cli-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,aAAa,CAAC;AAUrB,wBAAgB,eAAe,CAAC,KAAK,SAAS,GAAG,MAAM,CAQtD;AAED,+EAA+E;AAC/E,eAAO,MAAM,SAAS,QAAoB,CAAC;AAE3C,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAGlD;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAE5D"}

package/dist/cli-logger.js

@@ -0,0 +1,28 @@
+import pino from 'pino';
+import 'pino-pretty';
+const CLI_PRETTY_OPTIONS = {
+    colorize: true,
+    levelFirst: true,
+    translateTime: 'SYS:HH:MM:ss.l',
+    ignore: 'pid,hostname',
+    hideObject: true,
+};
+export function createCliLogger(level = 'info') {
+    return pino({
+        level,
+        transport: {
+            target: 'pino-pretty',
+            options: CLI_PRETTY_OPTIONS,
+        },
+    });
+}
+/** Default logger for scripts that do not load a custom log level from env. */
+export const cliLogger = createCliLogger();
+export function logFatalAndExit(msg) {
+    cliLogger.error(msg);
+    process.exit(1);
+}
+export function logFatalAndExitFromError(err) {
+    logFatalAndExit(err instanceof Error ? err.message : String(err));
+}
+//# sourceMappingURL=cli-logger.js.map

package/dist/cli-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-logger.js","sourceRoot":"","sources":["../src/cli-logger.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,aAAa,CAAC;AAErB,MAAM,kBAAkB,GAAG;IACvB,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,gBAAgB;IAC/B,MAAM,EAAE,cAAc;IACtB,UAAU,EAAE,IAAI;CACV,CAAC;AAEX,MAAM,UAAU,eAAe,CAAC,KAAK,GAAG,MAAM;IAC1C,OAAO,IAAI,CAAC;QACR,KAAK;QACL,SAAS,EAAE;YACP,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,kBAAkB;SAC9B;KACJ,CAAC,CAAC;AACP,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;AAE3C,MAAM,UAAU,eAAe,CAAC,GAAW;IACvC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAY;IACjD,eAAe,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/cli-table.d.ts

@@ -0,0 +1,3 @@
+/** Print tabular CLI output (intentional stdout; not for application logging). */
+export declare function cliTable(rows: Record<string, unknown>[]): void;
+//# sourceMappingURL=cli-table.d.ts.map

package/dist/cli-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-table.d.ts","sourceRoot":"","sources":["../src/cli-table.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAE9D"}

package/dist/cli-table.js

@@ -0,0 +1,5 @@
+/** Print tabular CLI output (intentional stdout; not for application logging). */
+export function cliTable(rows) {
+    console.table(rows);
+}
+//# sourceMappingURL=cli-table.js.map

package/dist/cli-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-table.js","sourceRoot":"","sources":["../src/cli-table.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,UAAU,QAAQ,CAAC,IAA+B;IACpD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { cliLogger, createCliLogger, logFatalAndExit, logFatalAndExitFromError } from './cli-logger.js';
+export { cliTable } from './cli-table.js';
+export { runCommand } from './run-command.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AACxG,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { cliLogger, createCliLogger, logFatalAndExit, logFatalAndExitFromError } from './cli-logger.js';
+export { cliTable } from './cli-table.js';
+export { runCommand } from './run-command.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AACxG,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/run-command.d.ts

@@ -0,0 +1,5 @@
+export declare function runCommand(command: string, args: string[], options?: {
+    cwd: string;
+    env?: Record<string, string | undefined>;
+}): void;
+//# sourceMappingURL=run-command.d.ts.map

package/dist/run-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.d.ts","sourceRoot":"","sources":["../src/run-command.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CAA2B,GAC5F,IAAI,CASN"}

package/dist/run-command.js

@@ -0,0 +1,12 @@
+import { spawnSync } from 'node:child_process';
+export function runCommand(command, args, options = { cwd: process.cwd() }) {
+    const result = spawnSync(command, args, {
+        cwd: options.cwd,
+        stdio: 'inherit',
+        env: { ...process.env, ...options.env },
+    });
+    if (result.status !== 0) {
+        process.exit(result.status ?? 1);
+    }
+}
+//# sourceMappingURL=run-command.js.map

package/dist/run-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.js","sourceRoot":"","sources":["../src/run-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,UAAU,UAAU,CACtB,OAAe,EACf,IAAc,EACd,UAAqE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE;IAE3F,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE;QACpC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;KAC1C,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@kristijorgji/cli-kit",
+  "version": "0.1.0",
+  "description": "Shared CLI primitives: pino-pretty logger, table printer, spawn wrapper",
+  "type": "module",
+  "license": "MIT",
+  "author": "kristijorgji",
+  "engines": {
+    "node": ">=22.16.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kristijorgji/js-devkit.git",
+    "directory": "packages/cli-kit"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "pino": "^9",
+    "pino-pretty": "^13"
+  },
+  "devDependencies": {
+    "@types/node": "^26",
+    "typescript": "^5",
+    "vitest": "^4"
+  }
+}