@decaf-ts/utils 1.1.0 → 1.2.0

package/lib/types/writers/RegexpOutputWriter.d.cts

@@ -0,0 +1,110 @@
+import { StandardOutputWriter } from "./StandardOutputWriter.cjs";
+import { PromiseExecutor } from "../utils/types.cjs";
+/**
+ * @description A specialized output writer that uses regular expressions to process output.
+ * @summary This class extends StandardOutputWriter to provide regex-based output processing.
+ * It allows for pattern matching in the output stream and can trigger specific actions
+ * based on matched patterns.
+ *
+ * @template T - The type of the resolved value, defaulting to string.
+ *
+ * @param cmd - The command string to be executed.
+ * @param lock - A PromiseExecutor to control the asynchronous flow.
+ * @param regexp - A string or RegExp to match against the output.
+ * @param flags - Optional flags for the RegExp constructor, defaults to "g".
+ *
+ * @class
+ * @example
+ * ```typescript
+ * import { RegexpOutputWriter } from '@decaf-ts/utils';
+ * import { PromiseExecutor } from '@decaf-ts/utils';
+ *
+ * // Create a promise executor
+ * const executor: PromiseExecutor<string, Error> = {
+ *   resolve: (value) => console.log(`Resolved: ${value}`),
+ *   reject: (error) => console.error(`Rejected: ${error.message}`)
+ * };
+ *
+ * // Create a regexp output writer that matches version numbers
+ * const writer = new RegexpOutputWriter('node --version', executor, /v(\d+\.\d+\.\d+)/);
+ *
+ * // Use the writer to handle command output
+ * writer.data('v14.17.0');  // This will automatically resolve with "v14.17.0"
+ * ```
+ *
+ * @mermaid
+ * sequenceDiagram
+ *   participant Client
+ *   participant RegexpOutputWriter
+ *   participant StandardOutputWriter
+ *   participant Logger
+ *
+ *   Client->>RegexpOutputWriter: new RegexpOutputWriter(cmd, lock, regexp, flags)
+ *   RegexpOutputWriter->>StandardOutputWriter: super(cmd, lock)
+ *   StandardOutputWriter->>Logger: Logging.for(cmd)
+ *   RegexpOutputWriter->>RegexpOutputWriter: compile regexp
+ *
+ *   Client->>RegexpOutputWriter: data(chunk)
+ *   RegexpOutputWriter->>StandardOutputWriter: super.data(chunk)
+ *   StandardOutputWriter->>Logger: logger.info(log)
+ *   RegexpOutputWriter->>RegexpOutputWriter: testAndResolve(chunk)
+ *   RegexpOutputWriter->>RegexpOutputWriter: test(chunk)
+ *   alt match found
+ *     RegexpOutputWriter->>RegexpOutputWriter: resolve(match[0])
+ *     RegexpOutputWriter->>StandardOutputWriter: resolve(match[0])
+ *   end
+ *
+ *   Client->>RegexpOutputWriter: error(chunk)
+ *   RegexpOutputWriter->>StandardOutputWriter: super.error(chunk)
+ *   StandardOutputWriter->>Logger: logger.info(log)
+ *   RegexpOutputWriter->>RegexpOutputWriter: testAndReject(chunk)
+ *   RegexpOutputWriter->>RegexpOutputWriter: test(chunk)
+ *   alt match found
+ *     RegexpOutputWriter->>RegexpOutputWriter: reject(match[0])
+ *     RegexpOutputWriter->>StandardOutputWriter: reject(match[0])
+ *   end
+ */
+export declare class RegexpOutputWriter extends StandardOutputWriter<string> {
+    /**
+     * @description The regular expression used for matching output.
+     * @summary This readonly property stores the compiled RegExp used for pattern matching.
+     */
+    protected readonly regexp: RegExp;
+    constructor(cmd: string, lock: PromiseExecutor<string, Error>, regexp: string | RegExp, flags?: string);
+    /**
+     * @description Tests the input data against the stored regular expression.
+     * @summary Executes the regular expression on the input data and returns the match result.
+     *
+     * @param data - The string to test against the regular expression.
+     * @return The result of the regular expression execution, or undefined if an error occurs.
+     */
+    private test;
+    /**
+     * @description Tests the data and resolves the promise if a match is found.
+     * @summary Executes the test method and resolves the promise with the first match group if successful.
+     *
+     * @param data - The string to test against the regular expression.
+     */
+    protected testAndResolve(data: string): void;
+    /**
+     * @description Tests the data and rejects the promise if a match is found.
+     * @summary Executes the test method and rejects the promise with the first match group if successful.
+     *
+     * @param data - The string to test against the regular expression.
+     */
+    protected testAndReject(data: string): void;
+    /**
+     * @description Processes incoming data chunks.
+     * @summary Calls the parent class data method and then tests the data for a match to potentially resolve the promise.
+     *
+     * @param chunk - The data chunk to process.
+     */
+    data(chunk: any): void;
+    /**
+     * @description Processes incoming error chunks.
+     * @summary Calls the parent class error method and then tests the data for a match to potentially reject the promise.
+     *
+     * @param chunk - The error chunk to process.
+     */
+    error(chunk: any): void;
+}

package/lib/types/writers/RegexpOutputWriter.d.mts

@@ -0,0 +1,110 @@
+import { StandardOutputWriter } from "./StandardOutputWriter.js";
+import { PromiseExecutor } from "../utils/types.js";
+/**
+ * @description A specialized output writer that uses regular expressions to process output.
+ * @summary This class extends StandardOutputWriter to provide regex-based output processing.
+ * It allows for pattern matching in the output stream and can trigger specific actions
+ * based on matched patterns.
+ *
+ * @template T - The type of the resolved value, defaulting to string.
+ *
+ * @param cmd - The command string to be executed.
+ * @param lock - A PromiseExecutor to control the asynchronous flow.
+ * @param regexp - A string or RegExp to match against the output.
+ * @param flags - Optional flags for the RegExp constructor, defaults to "g".
+ *
+ * @class
+ * @example
+ * ```typescript
+ * import { RegexpOutputWriter } from '@decaf-ts/utils';
+ * import { PromiseExecutor } from '@decaf-ts/utils';
+ *
+ * // Create a promise executor
+ * const executor: PromiseExecutor<string, Error> = {
+ *   resolve: (value) => console.log(`Resolved: ${value}`),
+ *   reject: (error) => console.error(`Rejected: ${error.message}`)
+ * };
+ *
+ * // Create a regexp output writer that matches version numbers
+ * const writer = new RegexpOutputWriter('node --version', executor, /v(\d+\.\d+\.\d+)/);
+ *
+ * // Use the writer to handle command output
+ * writer.data('v14.17.0');  // This will automatically resolve with "v14.17.0"
+ * ```
+ *
+ * @mermaid
+ * sequenceDiagram
+ *   participant Client
+ *   participant RegexpOutputWriter
+ *   participant StandardOutputWriter
+ *   participant Logger
+ *
+ *   Client->>RegexpOutputWriter: new RegexpOutputWriter(cmd, lock, regexp, flags)
+ *   RegexpOutputWriter->>StandardOutputWriter: super(cmd, lock)
+ *   StandardOutputWriter->>Logger: Logging.for(cmd)
+ *   RegexpOutputWriter->>RegexpOutputWriter: compile regexp
+ *
+ *   Client->>RegexpOutputWriter: data(chunk)
+ *   RegexpOutputWriter->>StandardOutputWriter: super.data(chunk)
+ *   StandardOutputWriter->>Logger: logger.info(log)
+ *   RegexpOutputWriter->>RegexpOutputWriter: testAndResolve(chunk)
+ *   RegexpOutputWriter->>RegexpOutputWriter: test(chunk)
+ *   alt match found
+ *     RegexpOutputWriter->>RegexpOutputWriter: resolve(match[0])
+ *     RegexpOutputWriter->>StandardOutputWriter: resolve(match[0])
+ *   end
+ *
+ *   Client->>RegexpOutputWriter: error(chunk)
+ *   RegexpOutputWriter->>StandardOutputWriter: super.error(chunk)
+ *   StandardOutputWriter->>Logger: logger.info(log)
+ *   RegexpOutputWriter->>RegexpOutputWriter: testAndReject(chunk)
+ *   RegexpOutputWriter->>RegexpOutputWriter: test(chunk)
+ *   alt match found
+ *     RegexpOutputWriter->>RegexpOutputWriter: reject(match[0])
+ *     RegexpOutputWriter->>StandardOutputWriter: reject(match[0])
+ *   end
+ */
+export declare class RegexpOutputWriter extends StandardOutputWriter<string> {
+    /**
+     * @description The regular expression used for matching output.
+     * @summary This readonly property stores the compiled RegExp used for pattern matching.
+     */
+    protected readonly regexp: RegExp;
+    constructor(cmd: string, lock: PromiseExecutor<string, Error>, regexp: string | RegExp, flags?: string);
+    /**
+     * @description Tests the input data against the stored regular expression.
+     * @summary Executes the regular expression on the input data and returns the match result.
+     *
+     * @param data - The string to test against the regular expression.
+     * @return The result of the regular expression execution, or undefined if an error occurs.
+     */
+    private test;
+    /**
+     * @description Tests the data and resolves the promise if a match is found.
+     * @summary Executes the test method and resolves the promise with the first match group if successful.
+     *
+     * @param data - The string to test against the regular expression.
+     */
+    protected testAndResolve(data: string): void;
+    /**
+     * @description Tests the data and rejects the promise if a match is found.
+     * @summary Executes the test method and rejects the promise with the first match group if successful.
+     *
+     * @param data - The string to test against the regular expression.
+     */
+    protected testAndReject(data: string): void;
+    /**
+     * @description Processes incoming data chunks.
+     * @summary Calls the parent class data method and then tests the data for a match to potentially resolve the promise.
+     *
+     * @param chunk - The data chunk to process.
+     */
+    data(chunk: any): void;
+    /**
+     * @description Processes incoming error chunks.
+     * @summary Calls the parent class error method and then tests the data for a match to potentially reject the promise.
+     *
+     * @param chunk - The error chunk to process.
+     */
+    error(chunk: any): void;
+}

package/lib/types/writers/StandardOutputWriter.d.cts

@@ -0,0 +1,130 @@
+import { OutputWriter } from "./OutputWriter.cjs";
+import { PromiseExecutor } from "../utils/types.cjs";
+import { OutputType } from "./types.cjs";
+import { Logger } from "@decaf-ts/logging";
+/**
+ * @description A standard output writer for handling command execution output.
+ * @summary This class implements the OutputWriter interface and provides methods for
+ * handling various types of output from command execution, including standard output,
+ * error output, and exit codes. It also includes utility methods for parsing commands
+ * and resolving or rejecting promises based on execution results.
+ *
+ * @template R - The type of the resolved value, defaulting to string.
+ *
+ * @param cmd - The command string to be executed.
+ * @param lock - A PromiseExecutor to control the asynchronous flow.
+ * @param args - Additional arguments (unused in the current implementation).
+ *
+ * @class
+ * @example
+ * ```typescript
+ * import { StandardOutputWriter } from '@decaf-ts/utils';
+ * import { PromiseExecutor } from '@decaf-ts/utils';
+ *
+ * // Create a promise executor
+ * const executor: PromiseExecutor<string> = {
+ *   resolve: (value) => console.log(`Resolved: ${value}`),
+ *   reject: (error) => console.error(`Rejected: ${error.message}`)
+ * };
+ *
+ * // Create a standard output writer
+ * const writer = new StandardOutputWriter('ls -la', executor);
+ *
+ * // Use the writer to handle command output
+ * writer.data('File list output...');
+ * writer.exit(0, ['Command executed successfully']);
+ * ```
+ *
+ * @mermaid
+ * sequenceDiagram
+ *   participant Client
+ *   participant StandardOutputWriter
+ *   participant Logger
+ *   participant PromiseExecutor
+ *
+ *   Client->>StandardOutputWriter: new StandardOutputWriter(cmd, lock)
+ *   StandardOutputWriter->>Logger: Logging.for(cmd)
+ *
+ *   Client->>StandardOutputWriter: data(chunk)
+ *   StandardOutputWriter->>StandardOutputWriter: log("stdout", chunk)
+ *   StandardOutputWriter->>Logger: logger.info(log)
+ *
+ *   Client->>StandardOutputWriter: error(chunk)
+ *   StandardOutputWriter->>StandardOutputWriter: log("stderr", chunk)
+ *   StandardOutputWriter->>Logger: logger.info(log)
+ *
+ *   Client->>StandardOutputWriter: exit(code, logs)
+ *   StandardOutputWriter->>StandardOutputWriter: log("stdout", exitMessage)
+ *   alt code === 0
+ *     StandardOutputWriter->>StandardOutputWriter: resolve(logs)
+ *     StandardOutputWriter->>PromiseExecutor: lock.resolve(reason)
+ *   else code !== 0
+ *     StandardOutputWriter->>StandardOutputWriter: reject(error)
+ *     StandardOutputWriter->>PromiseExecutor: lock.reject(reason)
+ *   end
+ */
+export declare class StandardOutputWriter<R = string> implements OutputWriter {
+    protected cmd: string;
+    protected lock: PromiseExecutor<R>;
+    protected logger: Logger;
+    constructor(cmd: string, lock: PromiseExecutor<R>, ...args: unknown[]);
+    /**
+     * @description Logs output to the console.
+     * @summary Formats and logs the given data with a timestamp and type indicator.
+     *
+     * @param type - The type of output (stdout or stderr).
+     * @param data - The data to be logged.
+     */
+    protected log(type: OutputType, data: string | Buffer): void;
+    /**
+     * @description Handles standard output data.
+     * @summary Logs the given chunk as standard output.
+     *
+     * @param chunk - The data chunk to be logged.
+     */
+    data(chunk: any): void;
+    /**
+     * @description Handles error output data.
+     * @summary Logs the given chunk as error output.
+     *
+     * @param chunk - The error data chunk to be logged.
+     */
+    error(chunk: any): void;
+    /**
+     * @description Handles error objects.
+     * @summary Logs the error message from the given Error object.
+     *
+     * @param err - The Error object to be logged.
+     */
+    errors(err: Error): void;
+    /**
+     * @description Handles the exit of a command.
+     * @summary Logs the exit code and resolves or rejects the promise based on the code.
+     *
+     * @param code - The exit code of the command.
+     * @param logs - Array of log messages to be processed before exiting.
+     */
+    exit(code: number | string, logs: string[]): void;
+    /**
+     * @description Parses a command string or array into components.
+     * @summary Converts the command into a consistent format and stores it, then returns it split into command and arguments.
+     *
+     * @param command - The command as a string or array of strings.
+     * @return A tuple containing the command and its arguments as separate elements.
+     */
+    parseCommand(command: string | string[]): [string, string[]];
+    /**
+     * @description Resolves the promise with a success message.
+     * @summary Logs a success message and resolves the promise with the given reason.
+     *
+     * @param reason - The reason for resolving the promise.
+     */
+    protected resolve(reason: R): void;
+    /**
+     * @description Rejects the promise with an error message.
+     * @summary Logs an error message and rejects the promise with the given reason.
+     *
+     * @param reason - The reason for rejecting the promise, either a number (exit code) or a string.
+     */
+    protected reject(reason: number | string | Error): void;
+}

package/lib/types/writers/StandardOutputWriter.d.mts

@@ -0,0 +1,130 @@
+import { OutputWriter } from "./OutputWriter.js";
+import { PromiseExecutor } from "../utils/types.js";
+import { OutputType } from "./types.js";
+import { Logger } from "@decaf-ts/logging";
+/**
+ * @description A standard output writer for handling command execution output.
+ * @summary This class implements the OutputWriter interface and provides methods for
+ * handling various types of output from command execution, including standard output,
+ * error output, and exit codes. It also includes utility methods for parsing commands
+ * and resolving or rejecting promises based on execution results.
+ *
+ * @template R - The type of the resolved value, defaulting to string.
+ *
+ * @param cmd - The command string to be executed.
+ * @param lock - A PromiseExecutor to control the asynchronous flow.
+ * @param args - Additional arguments (unused in the current implementation).
+ *
+ * @class
+ * @example
+ * ```typescript
+ * import { StandardOutputWriter } from '@decaf-ts/utils';
+ * import { PromiseExecutor } from '@decaf-ts/utils';
+ *
+ * // Create a promise executor
+ * const executor: PromiseExecutor<string> = {
+ *   resolve: (value) => console.log(`Resolved: ${value}`),
+ *   reject: (error) => console.error(`Rejected: ${error.message}`)
+ * };
+ *
+ * // Create a standard output writer
+ * const writer = new StandardOutputWriter('ls -la', executor);
+ *
+ * // Use the writer to handle command output
+ * writer.data('File list output...');
+ * writer.exit(0, ['Command executed successfully']);
+ * ```
+ *
+ * @mermaid
+ * sequenceDiagram
+ *   participant Client
+ *   participant StandardOutputWriter
+ *   participant Logger
+ *   participant PromiseExecutor
+ *
+ *   Client->>StandardOutputWriter: new StandardOutputWriter(cmd, lock)
+ *   StandardOutputWriter->>Logger: Logging.for(cmd)
+ *
+ *   Client->>StandardOutputWriter: data(chunk)
+ *   StandardOutputWriter->>StandardOutputWriter: log("stdout", chunk)
+ *   StandardOutputWriter->>Logger: logger.info(log)
+ *
+ *   Client->>StandardOutputWriter: error(chunk)
+ *   StandardOutputWriter->>StandardOutputWriter: log("stderr", chunk)
+ *   StandardOutputWriter->>Logger: logger.info(log)
+ *
+ *   Client->>StandardOutputWriter: exit(code, logs)
+ *   StandardOutputWriter->>StandardOutputWriter: log("stdout", exitMessage)
+ *   alt code === 0
+ *     StandardOutputWriter->>StandardOutputWriter: resolve(logs)
+ *     StandardOutputWriter->>PromiseExecutor: lock.resolve(reason)
+ *   else code !== 0
+ *     StandardOutputWriter->>StandardOutputWriter: reject(error)
+ *     StandardOutputWriter->>PromiseExecutor: lock.reject(reason)
+ *   end
+ */
+export declare class StandardOutputWriter<R = string> implements OutputWriter {
+    protected cmd: string;
+    protected lock: PromiseExecutor<R>;
+    protected logger: Logger;
+    constructor(cmd: string, lock: PromiseExecutor<R>, ...args: unknown[]);
+    /**
+     * @description Logs output to the console.
+     * @summary Formats and logs the given data with a timestamp and type indicator.
+     *
+     * @param type - The type of output (stdout or stderr).
+     * @param data - The data to be logged.
+     */
+    protected log(type: OutputType, data: string | Buffer): void;
+    /**
+     * @description Handles standard output data.
+     * @summary Logs the given chunk as standard output.
+     *
+     * @param chunk - The data chunk to be logged.
+     */
+    data(chunk: any): void;
+    /**
+     * @description Handles error output data.
+     * @summary Logs the given chunk as error output.
+     *
+     * @param chunk - The error data chunk to be logged.
+     */
+    error(chunk: any): void;
+    /**
+     * @description Handles error objects.
+     * @summary Logs the error message from the given Error object.
+     *
+     * @param err - The Error object to be logged.
+     */
+    errors(err: Error): void;
+    /**
+     * @description Handles the exit of a command.
+     * @summary Logs the exit code and resolves or rejects the promise based on the code.
+     *
+     * @param code - The exit code of the command.
+     * @param logs - Array of log messages to be processed before exiting.
+     */
+    exit(code: number | string, logs: string[]): void;
+    /**
+     * @description Parses a command string or array into components.
+     * @summary Converts the command into a consistent format and stores it, then returns it split into command and arguments.
+     *
+     * @param command - The command as a string or array of strings.
+     * @return A tuple containing the command and its arguments as separate elements.
+     */
+    parseCommand(command: string | string[]): [string, string[]];
+    /**
+     * @description Resolves the promise with a success message.
+     * @summary Logs a success message and resolves the promise with the given reason.
+     *
+     * @param reason - The reason for resolving the promise.
+     */
+    protected resolve(reason: R): void;
+    /**
+     * @description Rejects the promise with an error message.
+     * @summary Logs an error message and rejects the promise with the given reason.
+     *
+     * @param reason - The reason for rejecting the promise, either a number (exit code) or a string.
+     */
+    protected reject(reason: number | string | Error): void;
+}

package/lib/types/writers/index.d.cts

@@ -0,0 +1,4 @@
+export * from './OutputWriter.cjs';
+export * from './RegexpOutputWriter.cjs';
+export * from './StandardOutputWriter.cjs';
+export * from './types.cjs';

package/lib/types/writers/index.d.mts

@@ -0,0 +1,4 @@
+export * from './OutputWriter.js';
+export * from './RegexpOutputWriter.js';
+export * from './StandardOutputWriter.js';
+export * from './types.js';

package/lib/types/writers/types.d.cts

@@ -0,0 +1,29 @@
+import { StandardOutputWriter } from "./StandardOutputWriter.cjs";
+import { PromiseExecutor } from "../utils/types.cjs";
+/**
+ * @description Represents the type of output stream.
+ * @summary A union type for standard output and standard error streams.
+ * @typedef {("stdout" | "stderr")} OutputType
+ * @memberOf module:utils
+ */
+export type OutputType = "stdout" | "stderr";
+/**
+ * @description Constructor type for output writers.
+ * @summary Defines the structure for creating new output writer instances. This type represents
+ * a constructor function that takes a PromiseExecutor and additional arguments to create
+ * a new instance of an output writer. It allows for flexible creation of different types
+ * of output writers while maintaining a consistent interface.
+ *
+ * @template R - The type of the resolved value, defaulting to string.
+ * @template C - The type of the output writer, extending StandardOutputWriter<R>.
+ * @template E - The type of the error value, defaulting to number.
+ *
+ * @param {PromiseExecutor<R, E>} lock - The promise executor for managing asynchronous operations.
+ * @param {...unknown[]} args - Additional arguments passed to the constructor.
+ * @return {C} An instance of the output writer.
+ *
+ * @memberOf module:utils
+ */
+export type OutputWriterConstructor<R = string, C extends StandardOutputWriter<R> = StandardOutputWriter<R>, E = number> = {
+    new (cmd: string, lock: PromiseExecutor<R, E>, ...args: unknown[]): C;
+};

package/lib/types/writers/types.d.mts

@@ -0,0 +1,29 @@
+import { StandardOutputWriter } from "./StandardOutputWriter.js";
+import { PromiseExecutor } from "../utils/types.js";
+/**
+ * @description Represents the type of output stream.
+ * @summary A union type for standard output and standard error streams.
+ * @typedef {("stdout" | "stderr")} OutputType
+ * @memberOf module:utils
+ */
+export type OutputType = "stdout" | "stderr";
+/**
+ * @description Constructor type for output writers.
+ * @summary Defines the structure for creating new output writer instances. This type represents
+ * a constructor function that takes a PromiseExecutor and additional arguments to create
+ * a new instance of an output writer. It allows for flexible creation of different types
+ * of output writers while maintaining a consistent interface.
+ *
+ * @template R - The type of the resolved value, defaulting to string.
+ * @template C - The type of the output writer, extending StandardOutputWriter<R>.
+ * @template E - The type of the error value, defaulting to number.
+ *
+ * @param {PromiseExecutor<R, E>} lock - The promise executor for managing asynchronous operations.
+ * @param {...unknown[]} args - Additional arguments passed to the constructor.
+ * @return {C} An instance of the output writer.
+ *
+ * @memberOf module:utils
+ */
+export type OutputWriterConstructor<R = string, C extends StandardOutputWriter<R> = StandardOutputWriter<R>, E = number> = {
+    new (cmd: string, lock: PromiseExecutor<R, E>, ...args: unknown[]): C;
+};

package/package.json

@@ -1,25 +1,31 @@
 {
   "name": "@decaf-ts/utils",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "module management utils for decaf-ts",
   "type": "module",
   "exports": {
     ".": {
-      "types": "./lib/types/index.d.ts",
-      "import": "./lib/esm/index.js",
-      "require": "./lib/cjs/index.cjs",
+      "import": {
+        "default": "./lib/esm/index.js"
+      },
+      "require": {
+        "default": "./lib/esm/index.js"
+      },
       "default": "./lib/esm/index.js"
     },
     "./tests": {
-      "types": "./lib/types/tests/index.d.ts",
-      "import": "./lib/esm/tests/index.js",
-      "require": "./lib/cjs/tests/index.cjs",
+      "import": {
+        "default": "./lib/esm/tests/index.js"
+      },
+      "require": {
+        "default": "./lib/esm/tests/index.js"
+      },
       "default": "./lib/esm/tests/index.js"
     }
   },
   "main": "./lib/cjs/index.cjs",
   "module": "./lib/esm/index.js",
-  "types": "./lib/types/index.d.ts",
+  "types": "./lib/types/index.d.mts",
   "sideEffects": false,
   "bin": {
     "tag-release": "lib/cjs/bin/tag-release.cjs",