@tahminator/pipeline 1.0.63 → 1.0.65-beta.7047ce5c

package/README.md

@@ -252,6 +252,7 @@ await frontendClient.uploadTestCoverage();
 Assorted helper class used by clients and useful as an exported class to pipelines.
 
 ```ts
+// ----- strings -----
 const githubPrivateKey = await Utils.decodeBase64EncodedString(
   process.env.GH_PRIVATE_KEY_B64!,
 );
@@ -262,9 +263,42 @@ if (await Utils.isCmdAvailable("gh")) {
   console.log(Utils.Colors.green(`gh is installed (${shortId})`));
 }
 
-if (!Utils.SemVer.validate("1.2.3")) throw new Error("invalid version");
+// ----- required -----
+const token = Utils.required(process.env.GITHUB_TOKEN); // will throw if null or undefined
+
+// ----- wait / polling -----
+const reachable = await Utils.waitUntil({
+  predicate: async () => await Utils.isCmdAvailable("docker"),
+  attempts: 10,
+  intervalMs: 500,
+});
+
+if (!reachable) throw new Error("docker unavailable");
+
+// ----- debug -----
+if (Utils.Log.isDebug) {
+  console.log(Utils.Colors.dim("debug logging enabled"));
+}
 ```
 
+Available Utils APIs:
+
+- `Utils.decodeBase64EncodedString(s: string): string`
+- `Utils.generateShortId(len = 7): string`
+- `Utils.isCmdAvailable(cmd: string): Promise<boolean>`
+- `Utils.waitUntil({ predicate, attempts?, intervalMs? }): Promise<boolean>`
+- `Utils.required<T>(value: T | null | undefined): T`
+- `Utils.SemVer.validate(version: string | semver.SemVer): boolean`
+- `Utils.Log.isDebug: boolean` (`true` when `DEBUG=true`)
+- `Utils.Colors.<formatter>(s: string): string`
+
+`Utils.Colors` formatters:
+
+- `black`, `red`, `green`, `yellow`, `blue`, `magenta`, `cyan`, `white`, `gray`
+- `brightRed`, `brightGreen`, `brightYellow`, `brightBlue`, `brightMagenta`, `brightCyan`, `brightWhite`
+- `pink`, `orange`
+- `bold`, `dim`, `italic`, `underline`
+
 ### `EnvClient`
 
 Load environment variables from encrypted files and automatically mask them in GitHub Actions logs.

package/dist/utils/client.d.ts

@@ -4,6 +4,7 @@ import { Colors } from "./colors";
 import { Log } from "./log";
 import { SemVer } from "./semver";
 import { generateShortId } from "./short";
+import { required } from "./string";
 import { waitUntil } from "./wait";
 export declare class Utils {
     static Colors: typeof Colors;
@@ -13,4 +14,5 @@ export declare class Utils {
     static isCmdAvailable(...args: Parameters<typeof isCmdAvailable>): Promise<boolean>;
     static decodeBase64EncodedString(...args: Parameters<typeof decodeBase64EncodedString>): Promise<string>;
     static waitUntil(...args: Parameters<typeof waitUntil>): Promise<boolean>;
+    static required<T>(...args: Parameters<typeof required<T>>): T;
 }

package/dist/utils/client.js

@@ -4,6 +4,7 @@ import { Colors } from "./colors";
 import { Log } from "./log";
 import { SemVer } from "./semver";
 import { generateShortId } from "./short";
+import { required } from "./string";
 import { waitUntil } from "./wait";
 export class Utils {
     // hoist
@@ -22,4 +23,7 @@ export class Utils {
     static async waitUntil(...args) {
         return waitUntil(...args);
     }
+    static required(...args) {
+        return required(...args);
+    }
 }

package/dist/utils/string.d.ts

@@ -0,0 +1 @@
+export declare function required<T>(value: T | null | undefined): T;

package/dist/utils/string.js

@@ -0,0 +1,6 @@
+export function required(value) {
+    if (value == null) {
+        throw new Error("Expected a value but received null or undefined");
+    }
+    return value;
+}

package/dist/versioning/client.js

@@ -2,6 +2,7 @@ import semver from "semver";
 import { VersionUpdatingStrategy, } from "./types";
 import { JavaMavenVersioningClient } from "./updating/java/maven";
 import { JavascriptPackageJsonVersioningClient } from "./updating/jsts";
+import { NoneVersioningClient } from "./updating/none";
 export class VersioningClient {
     githubClient;
     static INITIAL_VERSION = "1.0.0";
@@ -16,6 +17,8 @@ export class VersioningClient {
                 return new JavascriptPackageJsonVersioningClient();
             case VersionUpdatingStrategy.JAVA_MAVEN:
                 return new JavaMavenVersioningClient();
+            case VersionUpdatingStrategy.NONE:
+                return new NoneVersioningClient();
         }
     }
     parseOrThrow(label, v) {

package/dist/versioning/types.d.ts

@@ -1,6 +1,7 @@
 export declare enum VersionUpdatingStrategy {
     JSTS = 0,
-    JAVA_MAVEN = 1
+    JAVA_MAVEN = 1,
+    NONE = 2
 }
 export interface IVersionUpdatingClient {
     update(version: string): Promise<void>;

package/dist/versioning/types.js

@@ -2,4 +2,5 @@ export var VersionUpdatingStrategy;
 (function (VersionUpdatingStrategy) {
     VersionUpdatingStrategy[VersionUpdatingStrategy["JSTS"] = 0] = "JSTS";
     VersionUpdatingStrategy[VersionUpdatingStrategy["JAVA_MAVEN"] = 1] = "JAVA_MAVEN";
+    VersionUpdatingStrategy[VersionUpdatingStrategy["NONE"] = 2] = "NONE";
 })(VersionUpdatingStrategy || (VersionUpdatingStrategy = {}));

package/dist/versioning/updating/none/index.d.ts

@@ -0,0 +1,5 @@
+import type { IJavascriptPackageJsonVersionUpdatingClient } from "../../types";
+import { BaseVersionUpdatingClient } from "../base";
+export declare class NoneVersioningClient extends BaseVersionUpdatingClient implements IJavascriptPackageJsonVersionUpdatingClient {
+    update(version: string): Promise<void>;
+}

package/dist/versioning/updating/none/index.js

@@ -0,0 +1,6 @@
+import { BaseVersionUpdatingClient } from "../base";
+export class NoneVersioningClient extends BaseVersionUpdatingClient {
+    async update(version) {
+        console.log(`NoneVersioningClient will not write ${version} anywhere.`);
+    }
+}

package/package.json

@@ -3,7 +3,7 @@
   "type": "module",
   "author": "Tahmid Ahmed",
   "description": "A collection of Bun shell scripts that can be re-used in various CICD pipelines.",
-  "version": "1.0.63",
+  "version": "1.0.65-beta.7047ce5c",
   "repository": {
     "url": "git+https://github.com/tahminator/pipeline.git"
   },