@decaf-ts/utils 1.0.10 → 1.2.0

package/lib/types/input/types.d.mts

@@ -0,0 +1,159 @@
+/**
+ * @description Represents a color function in the Kleur library.
+ * @summary The Color interface defines a function that can be called with or without arguments
+ * to apply color styling to text or chain multiple color operations.
+ *
+ * @interface Color
+ * @memberOf module:utils
+ * */
+export interface Color {
+    /**
+     * @description Applies the color to the given text.
+     * @param {string | number} x - The text or number to be colored.
+     * @return {string} The colored text.
+     */
+    (x: string | number): string;
+    /**
+     * @description Allows chaining of multiple color operations.
+     * @return {Kleur} The Kleur instance for method chaining.
+     */
+    (): Kleur;
+}
+/**
+ * @description Represents the main Kleur interface with all available color and style methods.
+ * @summary The Kleur interface provides methods for applying various colors, background colors,
+ * and text styles to strings in terminal output.
+ *
+ * @interface Kleur
+ * @memberOf module:utils
+ */
+export interface Kleur {
+    /** @description Applies black color to the text. */
+    black: Color;
+    /** @description Applies red color to the text. */
+    red: Color;
+    /** @description Applies green color to the text. */
+    green: Color;
+    /** @description Applies yellow color to the text. */
+    yellow: Color;
+    /** @description Applies blue color to the text. */
+    blue: Color;
+    /** @description Applies magenta color to the text. */
+    magenta: Color;
+    /** @description Applies cyan color to the text. */
+    cyan: Color;
+    /** @description Applies white color to the text. */
+    white: Color;
+    /** @description Applies gray color to the text. */
+    gray: Color;
+    /** @description Alias for gray color. */
+    grey: Color;
+    /** @description Applies black background to the text. */
+    bgBlack: Color;
+    /** @description Applies red background to the text. */
+    bgRed: Color;
+    /** @description Applies green background to the text. */
+    bgGreen: Color;
+    /** @description Applies yellow background to the text. */
+    bgYellow: Color;
+    /** @description Applies blue background to the text. */
+    bgBlue: Color;
+    /** @description Applies magenta background to the text. */
+    bgMagenta: Color;
+    /** @description Applies cyan background to the text. */
+    bgCyan: Color;
+    /** @description Applies white background to the text. */
+    bgWhite: Color;
+    /** @description Resets all applied styles. */
+    reset: Color;
+    /** @description Applies bold style to the text. */
+    bold: Color;
+    /** @description Applies dim (decreased intensity) style to the text. */
+    dim: Color;
+    /** @description Applies italic style to the text. */
+    italic: Color;
+    /** @description Applies underline style to the text. */
+    underline: Color;
+    /** @description Inverts the foreground and background colors. */
+    inverse: Color;
+    /** @description Hides the text (same color as background). */
+    hidden: Color;
+    /** @description Applies strikethrough style to the text. */
+    strikethrough: Color;
+}
+/**
+ * @description Configuration for a single command-line argument option.
+ * @summary Defines the structure and behavior of a command-line option.
+ * @interface ParseArgsOptionConfig
+ * @property {("string" | "boolean")} type - The data type of the option.
+ * @property {boolean} [multiple] - Whether the option can be specified multiple times.
+ * @property {string} [short] - The short (single-character) alias for the option.
+ * @property {string | boolean | string[] | boolean[]} [default] - The default value(s) for the option.
+ * @memberOf module:utils
+ */
+export interface ParseArgsOptionConfig {
+    type: "string" | "boolean";
+    multiple?: boolean | undefined;
+    short?: string | undefined;
+    default?: string | boolean | string[] | boolean[] | undefined;
+}
+/**
+ * @description Configuration for all command-line argument options.
+ * @summary A mapping of long option names to their configurations.
+ * @interface ParseArgsOptionsConfig
+ * @memberOf module:utils
+ */
+export interface ParseArgsOptionsConfig {
+    [longOption: string]: ParseArgsOptionConfig;
+}
+/**
+ * @description Represents a parsed command-line option token.
+ * @summary Can be either an option with a value or an option without a value.
+ * @typedef {Object} OptionToken
+ * @memberOf module:utils
+ */
+export type OptionToken = {
+    kind: "option";
+    index: number;
+    name: string;
+    rawName: string;
+    value: string;
+    inlineValue: boolean;
+} | {
+    kind: "option";
+    index: number;
+    name: string;
+    rawName: string;
+    value: undefined;
+    inlineValue: undefined;
+};
+/**
+ * @description Represents a parsed command-line token.
+ * @summary Can be an option, a positional argument, or an option terminator.
+ * @typedef {OptionToken | Object} Token
+ * @memberOf module:utils
+ */
+export type Token = OptionToken | {
+    kind: "positional";
+    index: number;
+    value: string;
+} | {
+    kind: "option-terminator";
+    index: number;
+};
+/**
+ * @description The result of parsing command-line arguments.
+ * @summary Contains parsed values, positional arguments, and optionally the parsed tokens.
+ * @typedef {Object} ParseArgsResult
+ * @property {string | boolean | string[] | boolean[] | undefined} values - Parsed option values.
+ * @property {string[]} positionals - Positional arguments.
+ * @property {Token[]} [tokens] - Parsed tokens (if requested).
+ * @memberOf module:utils
+ */
+export type ParseArgsResult = {
+    values: {
+        [p: string]: string | boolean | (string | boolean)[] | undefined;
+    };
+    positionals: string[];
+    tokens?: Token[];
+};

package/lib/types/output/common.d.cts

@@ -0,0 +1,53 @@
+import { Logger } from "@decaf-ts/logging";
+/**
+ * @description Prints a styled banner to the console.
+ * @summary Generates and prints a colorful ASCII art banner with a random slogan.
+ * @param {Logger} [logger] - Optional logger for verbose output.
+ * @memberOf module:utils
+ * @function printBanner
+ * @mermaid
+ * sequenceDiagram
+ *   participant printBanner
+ *   participant getSlogan
+ *   participant padEnd
+ *   participant console
+ *   printBanner->>getSlogan: Call getSlogan()
+ *   getSlogan-->>printBanner: Return random slogan
+ *   printBanner->>printBanner: Create banner ASCII art
+ *   printBanner->>printBanner: Split banner into lines
+ *   printBanner->>printBanner: Calculate max line length
+ *   printBanner->>padEnd: Call padEnd with slogan
+ *   padEnd-->>printBanner: Return padded slogan line
+ *   loop For each banner line
+ *     printBanner->>style: Call style(line)
+ *     style-->>printBanner: Return styled line
+ *     printBanner->>console: Log styled line
+ *   end
+ */
+export declare function printBanner(logger?: Logger): void;
+/**
+ * @description Retrieves a slogan from the predefined list.
+ * @summary Fetches a random slogan or a specific one by index from the slogans list.
+ * @param {number} [i] - Optional index to retrieve a specific slogan.
+ * @return {string} The selected slogan.
+ * @function getSlogan
+ * @memberOf module:utils
+ * @mermaid
+ * sequenceDiagram
+ *   participant getSlogan
+ *   participant Math.random
+ *   participant slogans
+ *   alt i is undefined
+ *     getSlogan->>Math.random: Generate random index
+ *     Math.random-->>getSlogan: Return random index
+ *   else i is defined
+ *     Note over getSlogan: Use provided index
+ *   end
+ *   getSlogan->>slogans: Access slogan at index
+ *   slogans-->>getSlogan: Return slogan
+ *   alt Error occurs
+ *     getSlogan->>getSlogan: Throw error
+ *   end
+ *   getSlogan-->>Caller: Return slogan
+ */
+export declare function getSlogan(i?: number): string;

package/lib/types/output/common.d.mts

@@ -0,0 +1,53 @@
+import { Logger } from "@decaf-ts/logging";
+/**
+ * @description Prints a styled banner to the console.
+ * @summary Generates and prints a colorful ASCII art banner with a random slogan.
+ * @param {Logger} [logger] - Optional logger for verbose output.
+ * @memberOf module:utils
+ * @function printBanner
+ * @mermaid
+ * sequenceDiagram
+ *   participant printBanner
+ *   participant getSlogan
+ *   participant padEnd
+ *   participant console
+ *   printBanner->>getSlogan: Call getSlogan()
+ *   getSlogan-->>printBanner: Return random slogan
+ *   printBanner->>printBanner: Create banner ASCII art
+ *   printBanner->>printBanner: Split banner into lines
+ *   printBanner->>printBanner: Calculate max line length
+ *   printBanner->>padEnd: Call padEnd with slogan
+ *   padEnd-->>printBanner: Return padded slogan line
+ *   loop For each banner line
+ *     printBanner->>style: Call style(line)
+ *     style-->>printBanner: Return styled line
+ *     printBanner->>console: Log styled line
+ *   end
+ */
+export declare function printBanner(logger?: Logger): void;
+/**
+ * @description Retrieves a slogan from the predefined list.
+ * @summary Fetches a random slogan or a specific one by index from the slogans list.
+ * @param {number} [i] - Optional index to retrieve a specific slogan.
+ * @return {string} The selected slogan.
+ * @function getSlogan
+ * @memberOf module:utils
+ * @mermaid
+ * sequenceDiagram
+ *   participant getSlogan
+ *   participant Math.random
+ *   participant slogans
+ *   alt i is undefined
+ *     getSlogan->>Math.random: Generate random index
+ *     Math.random-->>getSlogan: Return random index
+ *   else i is defined
+ *     Note over getSlogan: Use provided index
+ *   end
+ *   getSlogan->>slogans: Access slogan at index
+ *   slogans-->>getSlogan: Return slogan
+ *   alt Error occurs
+ *     getSlogan->>getSlogan: Throw error
+ *   end
+ *   getSlogan-->>Caller: Return slogan
+ */
+export declare function getSlogan(i?: number): string;

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

@@ -0,0 +1 @@
+export * from "./common.cjs";

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

@@ -0,0 +1 @@
+export * from "./common.js";

package/lib/types/release-chain/index.d.cts

@@ -0,0 +1,43 @@
+export interface ReleaseChainOptions {
+    metaRepoUrl: string;
+    branch: string;
+    currentRepo?: string;
+    packageName: string;
+    workspace?: string;
+    token?: string;
+    submoduleFile?: string;
+    submodulePath?: string;
+    targetBaseBranch?: string;
+}
+export interface ReleaseChainDispatchOptions {
+    metaRepoUrl: string;
+    branch: string;
+    workflowFile?: string;
+    repoSlug?: string;
+    currentRepo?: string;
+    token?: string;
+    ref?: string;
+    targetBaseBranch?: string;
+}
+export declare class ReleaseChainRunner {
+    private readonly options;
+    private readonly workspace;
+    private readonly clonesRoot;
+    private readonly token?;
+    private readonly metaRepoSlug;
+    private readonly currentRepo?;
+    constructor(options: ReleaseChainOptions);
+    run(): Promise<void>;
+    private evaluateModule;
+    private cloneRepository;
+    private checkoutTargetBranch;
+    private loadSubmodules;
+    private runCommand;
+    private githubRequest;
+    private findExistingPr;
+    private acceptPullRequest;
+    private createPullRequest;
+    private getDefaultBranch;
+}
+export declare function runReleaseChain(options: ReleaseChainOptions): Promise<void>;
+export declare function dispatchReleaseChainWorkflow(options: ReleaseChainDispatchOptions): Promise<void>;

package/lib/types/release-chain/index.d.mts

@@ -0,0 +1,43 @@
+export interface ReleaseChainOptions {
+    metaRepoUrl: string;
+    branch: string;
+    currentRepo?: string;
+    packageName: string;
+    workspace?: string;
+    token?: string;
+    submoduleFile?: string;
+    submodulePath?: string;
+    targetBaseBranch?: string;
+}
+export interface ReleaseChainDispatchOptions {
+    metaRepoUrl: string;
+    branch: string;
+    workflowFile?: string;
+    repoSlug?: string;
+    currentRepo?: string;
+    token?: string;
+    ref?: string;
+    targetBaseBranch?: string;
+}
+export declare class ReleaseChainRunner {
+    private readonly options;
+    private readonly workspace;
+    private readonly clonesRoot;
+    private readonly token?;
+    private readonly metaRepoSlug;
+    private readonly currentRepo?;
+    constructor(options: ReleaseChainOptions);
+    run(): Promise<void>;
+    private evaluateModule;
+    private cloneRepository;
+    private checkoutTargetBranch;
+    private loadSubmodules;
+    private runCommand;
+    private githubRequest;
+    private findExistingPr;
+    private acceptPullRequest;
+    private createPullRequest;
+    private getDefaultBranch;
+}
+export declare function runReleaseChain(options: ReleaseChainOptions): Promise<void>;
+export declare function dispatchReleaseChainWorkflow(options: ReleaseChainDispatchOptions): Promise<void>;

package/lib/types/tests/Consumer.d.cts

@@ -0,0 +1,151 @@
+import { LoggedClass } from "@decaf-ts/logging";
+import { TestReporter } from "./TestReporter.cjs";
+/**
+ * @description Store for logs indexed by identifier.
+ * @summary A record where keys are identifiers and values are arrays of log strings.
+ * @typedef {Record<number, string[]>} LogStore
+ * @memberOf module:utils
+ */
+type LogStore = Record<number, string[]>;
+/**
+ * @description Structure of a parsed log entry.
+ * @summary Contains timestamp, child identifier, and action.
+ * @interface ParsedLog
+ * @property {number} timestamp - The timestamp of the log.
+ * @property {string} child - The child identifier.
+ * @property {string} action - The action performed.
+ * @memberOf module:utils
+ */
+export interface ParsedLog {
+    timestamp: number;
+    child: string;
+    action: string;
+}
+/**
+ * @description Result of a comparison between consumer and producer logs.
+ * @summary Contains arrays of parsed logs for both consumer and producer.
+ * @interface ComparerResult
+ * @property {ParsedLog[]} consumer - The parsed consumer logs.
+ * @property {ParsedLog[]} producer - The parsed producer logs.
+ * @memberOf module:utils
+ */
+export interface ComparerResult {
+    consumer: ParsedLog[];
+    producer: ParsedLog[];
+}
+/**
+ * @description Function type for comparing consumer and producer data.
+ * @summary Compares two LogStores and returns a Promise resolving to ComparerResult.
+ * @typedef {function(LogStore, LogStore): Promise<ComparerResult>} Comparer
+ * @memberOf module:utils
+ */
+type Comparer = (consumerData: LogStore, producerData: LogStore) => Promise<ComparerResult>;
+/**
+ * @description Function type for handling consumer actions.
+ * @summary A function that takes an identifier and optional arguments, returning a result.
+ * @typedef {function(number, ...unknown[]): unknown | Promise<unknown>} ConsumerHandler
+ * @memberOf module:utils
+ */
+type ConsumerHandler = (identifier: number, ...args: unknown[]) => unknown | Promise<unknown>;
+/**
+ * @description Default comparer function for consumer and producer logs.
+ * @summary Sorts and compares consumer and producer logs to ensure they match.
+ * @param {LogStore} consumerData - The consumer logs.
+ * @param {LogStore} producerData - The producer logs.
+ * @return {Promise<ComparerResult>} The comparison result.
+ * @function defaultComparer
+ * @memberOf module:utils
+ */
+export declare const defaultComparer: Comparer;
+/**
+ * @description Options for the reporting comparer.
+ * @summary Configuration options for the reportingComparer function.
+ * @interface ReportingComparerOptions
+ * @property {TestReporter} [reporter] - The test reporter instance.
+ * @property {string} [testCase] - The test case name.
+ * @property {string} [referencePrefix] - The prefix for report references.
+ * @memberOf module:utils
+ */
+export interface ReportingComparerOptions {
+    reporter?: TestReporter;
+    testCase?: string;
+    referencePrefix?: string;
+}
+/**
+ * @description Comparer function that reports results using TestReporter.
+ * @summary Compares logs and generates a report with tables and messages.
+ * @param {LogStore} consumerData - The consumer logs.
+ * @param {LogStore} producerData - The producer logs.
+ * @param {ReportingComparerOptions} [options] - Options for reporting.
+ * @return {Promise<ComparerResult>} The comparison result.
+ * @function reportingComparer
+ * @memberOf module:utils
+ */
+export declare const reportingComparer: (consumerData: LogStore, producerData: LogStore, options?: ReportingComparerOptions) => Promise<ComparerResult>;
+/**
+ * @class ConsumerRunner
+ * @description Runs a consumer process and manages producer child processes.
+ * @summary Orchestrates the execution of consumer and producer processes, collects logs, and compares results.
+ * @param {string} action - The action name.
+ * @param {ConsumerHandler} consumerHandler - The handler function for the consumer.
+ * @param {Comparer} [compareHandler] - Optional custom comparer function.
+ * @memberOf module:utils
+ */
+export declare class ConsumerRunner extends LoggedClass {
+    private readonly action;
+    private readonly handler;
+    private readonly comparerHandle;
+    private forkedCache;
+    private consumerResults;
+    private producerResults;
+    private childExitPromises;
+    private completionTriggered;
+    private producerCompletion;
+    private consumerCompletion;
+    private expectedIterations;
+    private activeHandlers;
+    constructor(action: string, consumerHandler: ConsumerHandler, compareHandler?: Comparer);
+    private reset;
+    private waitForChildExit;
+    private store;
+    private recordConsumer;
+    private isProducerComplete;
+    private isConsumerComplete;
+    private terminateChildren;
+    /**
+     * @description Runs the consumer and producer processes.
+     * @summary Starts the producer child processes and the consumer handler, then waits for completion and compares results.
+     * @param {number} count - The number of producers.
+     * @param {number} [timeout] - The timeout for producers.
+     * @param {number} times - The number of times to repeat.
+     * @param {boolean} [random] - Whether to use random timeouts.
+     * @return {Promise<ComparerResult>} The comparison result.
+     * @mermaid
+     * sequenceDiagram
+     *   participant Runner as ConsumerRunner
+     *   participant Child as ProducerChild
+     *   participant Handler as ConsumerHandler
+     *   participant Comparer as Comparer
+     *   Runner->>Runner: reset()
+     *   loop For each count
+     *     Runner->>Child: fork()
+     *     Runner->>Runner: Store child process
+     *   end
+     *   Runner->>Child: send(start message)
+     *   loop For each message from Child
+     *     Child->>Runner: message(action)
+     *     Runner->>Runner: store producer log
+     *     Runner->>Handler: call handler
+     *     Handler-->>Runner: return
+     *     Runner->>Runner: record consumer log
+     *     Runner->>Runner: finalizeIfComplete()
+     *   end
+     *   alt Complete
+     *     Runner->>Comparer: compare logs
+     *     Comparer-->>Runner: return result
+     *     Runner-->>Caller: resolve(result)
+     *   end
+     */
+    run(count: number, timeout: number | undefined, times: number, random: boolean | undefined): Promise<ComparerResult>;
+}
+export {};

package/lib/types/tests/Consumer.d.mts

@@ -0,0 +1,151 @@
+import { LoggedClass } from "@decaf-ts/logging";
+import { TestReporter } from "./TestReporter.js";
+/**
+ * @description Store for logs indexed by identifier.
+ * @summary A record where keys are identifiers and values are arrays of log strings.
+ * @typedef {Record<number, string[]>} LogStore
+ * @memberOf module:utils
+ */
+type LogStore = Record<number, string[]>;
+/**
+ * @description Structure of a parsed log entry.
+ * @summary Contains timestamp, child identifier, and action.
+ * @interface ParsedLog
+ * @property {number} timestamp - The timestamp of the log.
+ * @property {string} child - The child identifier.
+ * @property {string} action - The action performed.
+ * @memberOf module:utils
+ */
+export interface ParsedLog {
+    timestamp: number;
+    child: string;
+    action: string;
+}
+/**
+ * @description Result of a comparison between consumer and producer logs.
+ * @summary Contains arrays of parsed logs for both consumer and producer.
+ * @interface ComparerResult
+ * @property {ParsedLog[]} consumer - The parsed consumer logs.
+ * @property {ParsedLog[]} producer - The parsed producer logs.
+ * @memberOf module:utils
+ */
+export interface ComparerResult {
+    consumer: ParsedLog[];
+    producer: ParsedLog[];
+}
+/**
+ * @description Function type for comparing consumer and producer data.
+ * @summary Compares two LogStores and returns a Promise resolving to ComparerResult.
+ * @typedef {function(LogStore, LogStore): Promise<ComparerResult>} Comparer
+ * @memberOf module:utils
+ */
+type Comparer = (consumerData: LogStore, producerData: LogStore) => Promise<ComparerResult>;
+/**
+ * @description Function type for handling consumer actions.
+ * @summary A function that takes an identifier and optional arguments, returning a result.
+ * @typedef {function(number, ...unknown[]): unknown | Promise<unknown>} ConsumerHandler
+ * @memberOf module:utils
+ */
+type ConsumerHandler = (identifier: number, ...args: unknown[]) => unknown | Promise<unknown>;
+/**
+ * @description Default comparer function for consumer and producer logs.
+ * @summary Sorts and compares consumer and producer logs to ensure they match.
+ * @param {LogStore} consumerData - The consumer logs.
+ * @param {LogStore} producerData - The producer logs.
+ * @return {Promise<ComparerResult>} The comparison result.
+ * @function defaultComparer
+ * @memberOf module:utils
+ */
+export declare const defaultComparer: Comparer;
+/**
+ * @description Options for the reporting comparer.
+ * @summary Configuration options for the reportingComparer function.
+ * @interface ReportingComparerOptions
+ * @property {TestReporter} [reporter] - The test reporter instance.
+ * @property {string} [testCase] - The test case name.
+ * @property {string} [referencePrefix] - The prefix for report references.
+ * @memberOf module:utils
+ */
+export interface ReportingComparerOptions {
+    reporter?: TestReporter;
+    testCase?: string;
+    referencePrefix?: string;
+}
+/**
+ * @description Comparer function that reports results using TestReporter.
+ * @summary Compares logs and generates a report with tables and messages.
+ * @param {LogStore} consumerData - The consumer logs.
+ * @param {LogStore} producerData - The producer logs.
+ * @param {ReportingComparerOptions} [options] - Options for reporting.
+ * @return {Promise<ComparerResult>} The comparison result.
+ * @function reportingComparer
+ * @memberOf module:utils
+ */
+export declare const reportingComparer: (consumerData: LogStore, producerData: LogStore, options?: ReportingComparerOptions) => Promise<ComparerResult>;
+/**
+ * @class ConsumerRunner
+ * @description Runs a consumer process and manages producer child processes.
+ * @summary Orchestrates the execution of consumer and producer processes, collects logs, and compares results.
+ * @param {string} action - The action name.
+ * @param {ConsumerHandler} consumerHandler - The handler function for the consumer.
+ * @param {Comparer} [compareHandler] - Optional custom comparer function.
+ * @memberOf module:utils
+ */
+export declare class ConsumerRunner extends LoggedClass {
+    private readonly action;
+    private readonly handler;
+    private readonly comparerHandle;
+    private forkedCache;
+    private consumerResults;
+    private producerResults;
+    private childExitPromises;
+    private completionTriggered;
+    private producerCompletion;
+    private consumerCompletion;
+    private expectedIterations;
+    private activeHandlers;
+    constructor(action: string, consumerHandler: ConsumerHandler, compareHandler?: Comparer);
+    private reset;
+    private waitForChildExit;
+    private store;
+    private recordConsumer;
+    private isProducerComplete;
+    private isConsumerComplete;
+    private terminateChildren;
+    /**
+     * @description Runs the consumer and producer processes.
+     * @summary Starts the producer child processes and the consumer handler, then waits for completion and compares results.
+     * @param {number} count - The number of producers.
+     * @param {number} [timeout] - The timeout for producers.
+     * @param {number} times - The number of times to repeat.
+     * @param {boolean} [random] - Whether to use random timeouts.
+     * @return {Promise<ComparerResult>} The comparison result.
+     * @mermaid
+     * sequenceDiagram
+     *   participant Runner as ConsumerRunner
+     *   participant Child as ProducerChild
+     *   participant Handler as ConsumerHandler
+     *   participant Comparer as Comparer
+     *   Runner->>Runner: reset()
+     *   loop For each count
+     *     Runner->>Child: fork()
+     *     Runner->>Runner: Store child process
+     *   end
+     *   Runner->>Child: send(start message)
+     *   loop For each message from Child
+     *     Child->>Runner: message(action)
+     *     Runner->>Runner: store producer log
+     *     Runner->>Handler: call handler
+     *     Handler-->>Runner: return
+     *     Runner->>Runner: record consumer log
+     *     Runner->>Runner: finalizeIfComplete()
+     *   end
+     *   alt Complete
+     *     Runner->>Comparer: compare logs
+     *     Comparer-->>Runner: return result
+     *     Runner-->>Caller: resolve(result)
+     *   end
+     */
+    run(count: number, timeout: number | undefined, times: number, random: boolean | undefined): Promise<ComparerResult>;
+}
+export {};

package/lib/types/tests/ProducerChildProcess.d.cts

@@ -0,0 +1,18 @@
+type ParentMessage = {
+    identifier: number;
+    action: string;
+    timeout?: number;
+    times: number;
+    random?: boolean;
+    terminate?: boolean;
+};
+type ProducerResponse = {
+    identifier: number;
+    action: string;
+    timeout?: number;
+    times: number;
+    random?: boolean;
+    result?: string[];
+};
+declare let shuttingDown: boolean;
+declare const completeAndExit: (logMessage?: string) => void;