@actsecurity/cli 0.2.66

package/dist/esm/readRelative.js

@@ -0,0 +1,74 @@
+import { readFile } from 'fs/promises';
+import { join, sep } from 'path';
+class CommonJsPackageFileReader {
+    constructor(currentFile, levelsUp) {
+        const dirPath = currentFile.slice(0, currentFile.lastIndexOf(sep));
+        this.rootPath = join(dirPath, ...backSegments(levelsUp));
+    }
+    async readFile(pathParts) {
+        const fullPath = join(this.rootPath, ...pathParts);
+        return readFile(fullPath, 'utf8');
+    }
+}
+class EsmPackageFileReader {
+    constructor(currentFile, levelsUp) {
+        this.currentFile = currentFile;
+        this.levelsUp = levelsUp;
+    }
+    /**
+     * Lookup the root path of the project, going up the specified number of levels from the current file.
+     *
+     * @returns the root path of the project, calculated once and cached
+     */
+    async getRootPath() {
+        if (!this.rootPath) {
+            const dirPath = this.currentFile.slice(0, this.currentFile.lastIndexOf('/'));
+            const { fileURLToPath } = await import('node:url');
+            const startPath = fileURLToPath(dirPath);
+            this.rootPath = join(startPath, ...backSegments(this.levelsUp));
+        }
+        return this.rootPath;
+    }
+    async readFile(pathParts) {
+        const { join } = await import('node:path');
+        const root = await this.getRootPath();
+        const fullPath = join(root, ...pathParts);
+        return readFile(fullPath, 'utf8');
+    }
+}
+/**
+ * A relatively sane way to read a file from a relative path inside your packaged cli app. For instance to
+ * read the package.json inside your package. Works on ESM and CommonJS modules. Use __filename
+ * or import.meta.url to get the path of the file you are in and pass it to this function. Set the `levelsUp`
+ * based on how your project is packaged. For instance, if your file is packaged in `dist/cli.js` and you would use `1` if
+ * you packaged your file is in `dist/src/cli.js` and you would use `2`. Whatever you need to get to the root.
+ *
+ * You get back a `PackageFileReader` which has a `readFile` method. You can then call that method
+ * with the path parts to the file you want to read, relative to the root of your project.
+ * For instance, to read the `package.json` file in the root of your project, you would call:
+ * ```ts
+ *   const reader = await createPackageFileReader(import.meta.url, 1) // if your file is in dist/cli.js
+ *   const packageJson = await reader.readFile(['package.json'])
+ * ```
+ *
+ * @param currentFile the path to start from use `import.meta.url` for esm or `__filename` for CommonJS in most cases
+ * @param levelsUp since __import.meta.url or __filename is the file you are in, you need to go up a few levels to ge to the root of your project. Use 0 for the current directory of the file you're calling from.
+ * @returns a `PackageFileReader` you can use to read files relative to the root of your project.
+ */
+export function createPackageFileReader(currentFile, levelsUp) {
+    const isEsm = currentFile.startsWith('file://');
+    if (isEsm) {
+        return new EsmPackageFileReader(currentFile, levelsUp);
+    }
+    return new CommonJsPackageFileReader(currentFile, levelsUp);
+}
+/**
+ * Create an array of `..` segments to go up the specified number of levels in a path.
+ *
+ * @param levelsUp the number of levels to go up
+ * @returns an array of `..` segments
+ */
+function backSegments(levelsUp) {
+    return Array(levelsUp).fill('..');
+}
+//# sourceMappingURL=readRelative.js.map

package/dist/esm/readRelative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readRelative.js","sourceRoot":"","sources":["../../src/readRelative.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAiBhC,MAAM,yBAAyB;IAE7B,YAAY,WAAmB,EAAE,QAAgB;QAC/C,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;QAClE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC1D,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAmB;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,SAAS,CAAC,CAAA;QAClD,OAAO,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IACnC,CAAC;CACF;AAED,MAAM,oBAAoB;IAGxB,YACU,WAAmB,EACnB,QAAgB;QADhB,gBAAW,GAAX,WAAW,CAAQ;QACnB,aAAQ,GAAR,QAAQ,CAAQ;IACvB,CAAC;IAEJ;;;;OAIG;IACK,KAAK,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;YAC5E,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAA;YAClD,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;YACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;QACjE,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAmB;QAChC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAA;QAC1C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAA;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,SAAS,CAAC,CAAA;QACzC,OAAO,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IACnC,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAmB,EAAE,QAAgB;IAC3E,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;IAC/C,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,IAAI,oBAAoB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IACxD,CAAC;IACD,OAAO,IAAI,yBAAyB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;AAC7D,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,QAAgB;IACpC,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACnC,CAAC"}

package/dist/esm/stdin.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Read from stdin until the stream ends, timeout, or an error occurs
+ *
+ * @returns the string input from stdin
+ */
+export declare function readStdin(readWait: number | undefined): Promise<string>;
+//# sourceMappingURL=stdin.d.ts.map

package/dist/esm/stdin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.d.ts","sourceRoot":"","sources":["../../src/stdin.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CA+B7E"}

package/dist/esm/stdin.js

@@ -0,0 +1,35 @@
+import { stdin } from 'process';
+/**
+ * Read from stdin until the stream ends, timeout, or an error occurs
+ *
+ * @returns the string input from stdin
+ */
+export async function readStdin(readWait) {
+    return new Promise((resolve, reject) => {
+        // If the input is not a TTY, we are most likely receiving data from a pipe.
+        const definitelyReceivingData = !process.stdin.isTTY;
+        if (!readWait || readWait <= 0) {
+            readWait = definitelyReceivingData ? 10000 : 20;
+        }
+        let data = '';
+        const timeout = setTimeout(() => {
+            if (data.length === 0) {
+                stdin.pause();
+                stdin.removeAllListeners('data');
+                resolve(data);
+            }
+        }, readWait);
+        stdin.on('data', (chunk) => {
+            data += chunk;
+        });
+        stdin.on('end', () => {
+            resolve(data);
+            clearTimeout(timeout);
+        });
+        stdin.on('error', (err) => {
+            reject(err);
+            clearTimeout(timeout);
+        });
+    });
+}
+//# sourceMappingURL=stdin.js.map

package/dist/esm/stdin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.js","sourceRoot":"","sources":["../../src/stdin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAE/B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAA4B;IAC1D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,4EAA4E;QAC5E,MAAM,uBAAuB,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAA;QACpD,IAAI,CAAC,QAAQ,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAC/B,QAAQ,GAAG,uBAAuB,CAAC,CAAC,CAAC,KAAM,CAAC,CAAC,CAAC,EAAE,CAAA;QAClD,CAAC;QAED,IAAI,IAAI,GAAG,EAAE,CAAA;QACb,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,KAAK,CAAC,KAAK,EAAE,CAAA;gBACb,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAA;gBAChC,OAAO,CAAC,IAAI,CAAC,CAAA;YACf,CAAC;QACH,CAAC,EAAE,QAAQ,CAAC,CAAA;QAEZ,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,CAAA;QACf,CAAC,CAAC,CAAA;QAEF,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACnB,OAAO,CAAC,IAAI,CAAC,CAAA;YACb,YAAY,CAAC,OAAO,CAAC,CAAA;QACvB,CAAC,CAAC,CAAA;QAEF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,MAAM,CAAC,GAAG,CAAC,CAAA;YACX,YAAY,CAAC,OAAO,CAAC,CAAA;QACvB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/esm/utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Optionally print a message and exit the process with the given exit code.
+ *
+ * @param exitCode the exit code to use
+ * @param message the message to print
+ */
+export declare function exit(exitCode: number, message: string | undefined): void;
+/**
+ * A utility type to ensure that T has exactly the keys of U, no more and no less.
+ */
+export type NoExtraKeys<T, Shape> = {
+    [K in keyof T]: K extends keyof Shape ? T[K] : never;
+};
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,QASjE;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,KAAK,IAAI;KACjC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;CACrD,CAAA"}

package/dist/esm/utils.js

@@ -0,0 +1,18 @@
+/**
+ * Optionally print a message and exit the process with the given exit code.
+ *
+ * @param exitCode the exit code to use
+ * @param message the message to print
+ */
+export function exit(exitCode, message) {
+    if (message) {
+        if (exitCode === 0) {
+            console.log(message);
+        }
+        else {
+            console.error(message);
+        }
+    }
+    process.exit(exitCode);
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAC,QAAgB,EAAE,OAA2B;IAChE,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACtB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACxB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;AACxB,CAAC"}

package/package.json

@@ -0,0 +1,114 @@
+{
+  "name": "@actsecurity/cli",
+  "version": "0.2.66",
+  "description": "A standardized library for CLI building TypeScript CLI applications",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/act-security-labs/cli.git"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "types": "dist/cjs/index.d.ts",
+  "scripts": {
+    "build": "npx tsc -p tsconfig.cjs.json && npx tsc -p tsconfig.esm.json && ./postbuild.sh",
+    "clean": "rm -rf dist",
+    "test": "npx vitest --run --coverage",
+    "release": "npm install && npm run clean && npm run build && npm test && npm run format-check && npm publish",
+    "format": "npx prettier --write src/",
+    "format-check": "npx prettier --check src/"
+  },
+  "keywords": [
+    "AWS",
+    "IAM"
+  ],
+  "author": "David Kerber <dave@cloudcopilot.io>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/act-security-labs/cli/issues"
+  },
+  "homepage": "https://github.com/act-security-labs/cli#readme",
+  "devDependencies": {
+    "@actsecurity/prettier-config": "^0.1.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/exec": "^7.1.0",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.6",
+    "@semantic-release/npm": "^13.1.4",
+    "@semantic-release/release-notes-generator": "^14.0.3",
+    "@types/node": "^22.5.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "semantic-release": "^25.0.3",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.18"
+  },
+  "prettier": "@actsecurity/prettier-config",
+  "release": {
+    "branches": [
+      "main"
+    ],
+    "plugins": [
+      [
+        "@semantic-release/commit-analyzer",
+        {
+          "releaseRules": [
+            {
+              "type": "feat",
+              "release": "patch"
+            },
+            {
+              "type": "fix",
+              "release": "patch"
+            },
+            {
+              "breaking": true,
+              "release": "patch"
+            },
+            {
+              "type": "*",
+              "release": "patch"
+            }
+          ]
+        }
+      ],
+      "@semantic-release/release-notes-generator",
+      "@semantic-release/changelog",
+      [
+        "@semantic-release/npm",
+        {
+          "npmPublish": true
+        }
+      ],
+      [
+        "@semantic-release/exec",
+        {
+          "successCmd": "echo published=true >> $GITHUB_OUTPUT && echo version=${nextRelease.version} >> $GITHUB_OUTPUT && echo package_name=$(node -p \"require('./package.json').name\") >> $GITHUB_OUTPUT"
+        }
+      ],
+      [
+        "@semantic-release/git",
+        {
+          "assets": [
+            "package.json",
+            "package-lock.json",
+            "CHANGELOG.md"
+          ],
+          "message": "chore(release): ${nextRelease.version} [skip ci]"
+        }
+      ],
+      [
+        "@semantic-release/github",
+        {
+          "assets": []
+        }
+      ]
+    ]
+  }
+}