@fsai-flow/workflow 0.0.2 → 0.1.0

package/dist/src/lib/WorkflowHooks.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowHooks = void 0;
+class WorkflowHooks {
+    mode;
+    workflowData;
+    executionId;
+    sessionId;
+    retryOf;
+    hookFunctions;
+    constructor(hookFunctions, mode, executionId, workflowData, optionalParameters) {
+        // eslint-disable-next-line no-param-reassign, @typescript-eslint/prefer-nullish-coalescing
+        optionalParameters = optionalParameters || {};
+        this.hookFunctions = hookFunctions;
+        this.mode = mode;
+        this.executionId = executionId;
+        this.workflowData = workflowData;
+        this.sessionId = optionalParameters.sessionId;
+        this.retryOf = optionalParameters.retryOf;
+    }
+    async executeHookFunctions(hookName, parameters) {
+        if (this.hookFunctions[hookName] !== undefined && Array.isArray(this.hookFunctions[hookName])) {
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion, no-restricted-syntax
+            for (const hookFunction of this.hookFunctions[hookName]) {
+                // eslint-disable-next-line no-await-in-loop
+                await hookFunction.apply(this, parameters);
+            }
+        }
+    }
+}
+exports.WorkflowHooks = WorkflowHooks;
+//# sourceMappingURL=WorkflowHooks.js.map

package/dist/src/lib/WorkflowHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowHooks.js","sourceRoot":"","sources":["../../../src/lib/WorkflowHooks.ts"],"names":[],"mappings":";;;AAQA,MAAa,aAAa;IACzB,IAAI,CAAsB;IAE1B,YAAY,CAAgB;IAE5B,WAAW,CAAS;IAEpB,SAAS,CAAU;IAEnB,OAAO,CAAU;IAEjB,aAAa,CAAwB;IAErC,YACC,aAAoC,EACpC,IAAyB,EACzB,WAAmB,EACnB,YAA2B,EAC3B,kBAAqD;QAErD,2FAA2F;QAC3F,kBAAkB,GAAG,kBAAkB,IAAI,EAAE,CAAC;QAE9C,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,kBAAkB,CAAC,SAAS,CAAC;QAC9C,IAAI,CAAC,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,QAAgB,EAAE,UAAqB;QACjE,IAAI,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YAC/F,0FAA0F;YAC1F,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAE,EAAE,CAAC;gBAC1D,4CAA4C;gBAC5C,MAAM,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,UAAqB,CAAC,CAAC;YACvD,CAAC;QACF,CAAC;IACF,CAAC;CACD;AAxCD,sCAwCC"}

package/dist/src/lib/errors/base/base.error.d.ts

@@ -0,0 +1,30 @@
+import type { ErrorExtra, ErrorLevel, ErrorTags, ReportingOptions } from "../error.types";
+export type BaseErrorOptions = {
+    description?: undefined | null;
+} & ErrorOptions & ReportingOptions;
+interface ErrorOptions {
+    cause?: unknown;
+}
+/**
+ * Base class for all errors
+ */
+export declare abstract class BaseError extends Error {
+    /**
+     * Error level. Defines which level the error should be logged/reported
+     * @default 'error'
+     */
+    level: ErrorLevel;
+    /**
+     * Whether the error should be reported to Sentry.
+     * @default true
+     */
+    readonly shouldReport: boolean;
+    readonly description: string | null | undefined;
+    readonly tags: ErrorTags;
+    readonly extra?: ErrorExtra;
+    readonly packageName?: string;
+    readonly cause?: unknown;
+    constructor(message: string, { level, description, shouldReport, tags, extra, ...rest }?: BaseErrorOptions);
+}
+export {};
+//# sourceMappingURL=base.error.d.ts.map

package/dist/src/lib/errors/base/base.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.error.d.ts","sourceRoot":"","sources":["../../../../../src/lib/errors/base/base.error.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE1F,MAAM,MAAM,gBAAgB,GAAG;IAAE,WAAW,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;CAAE,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAEpG,UAAU,YAAY;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,8BAAsB,SAAU,SAAQ,KAAK;IAC5C;;;OAGG;IACH,KAAK,EAAE,UAAU,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAE/B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAEhD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAEzB,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAE5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAGjC,OAAO,EAAE,MAAM,EACf,EAAE,KAAe,EAAE,WAAW,EAAE,YAAY,EAAE,IAAS,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAE,gBAAqB;CAqBjG"}

package/dist/src/lib/errors/base/base.error.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseError = void 0;
+const callsites_1 = __importDefault(require("callsites"));
+/**
+ * Base class for all errors
+ */
+class BaseError extends Error {
+    /**
+     * Error level. Defines which level the error should be logged/reported
+     * @default 'error'
+     */
+    level;
+    /**
+     * Whether the error should be reported to Sentry.
+     * @default true
+     */
+    shouldReport;
+    description;
+    tags;
+    extra;
+    packageName;
+    cause;
+    constructor(message, { level = "error", description, shouldReport, tags = {}, extra, ...rest } = {}) {
+        super(message);
+        if (rest.cause !== undefined) {
+            this.cause = rest.cause;
+        }
+        this.level = level;
+        this.shouldReport = shouldReport ?? (level === "error" || level === "fatal");
+        this.description = description;
+        this.tags = tags;
+        this.extra = extra;
+        try {
+            const filePath = (0, callsites_1.default)()[2].getFileName() ?? "";
+            const match = /packages\/([^/]+)\//.exec(filePath)?.[1];
+            if (match)
+                this.tags.packageName = match;
+        }
+        catch { }
+    }
+}
+exports.BaseError = BaseError;
+//# sourceMappingURL=base.error.js.map

package/dist/src/lib/errors/base/base.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.error.js","sourceRoot":"","sources":["../../../../../src/lib/errors/base/base.error.ts"],"names":[],"mappings":";;;;;;AAAA,0DAAkC;AAUlC;;GAEG;AACH,MAAsB,SAAU,SAAQ,KAAK;IAC5C;;;OAGG;IACH,KAAK,CAAa;IAElB;;;OAGG;IACM,YAAY,CAAU;IAEtB,WAAW,CAA4B;IAEvC,IAAI,CAAY;IAEhB,KAAK,CAAc;IAEnB,WAAW,CAAU;IAEZ,KAAK,CAAW;IAElC,YACC,OAAe,EACf,EAAE,KAAK,GAAG,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,IAAI,KAAuB,EAAE;QAEhG,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,CAAC,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,OAAO,CAAC,CAAC;QAC7E,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,IAAA,mBAAS,GAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAExD,IAAI,KAAK;gBAAE,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACX,CAAC;CACD;AA9CD,8BA8CC"}

package/dist/src/lib/errors/base/operational.error.d.ts

@@ -0,0 +1,16 @@
+import type { BaseErrorOptions } from "./base.error";
+import { BaseError } from "./base.error";
+export type OperationalErrorOptions = Omit<BaseErrorOptions, "level"> & {
+    level?: "info" | "warning" | "error";
+};
+/**
+ * Error that indicates a transient issue, like a network request failing,
+ * a database query timing out, etc. These are expected to happen, are
+ * transient by nature and should be handled gracefully.
+ *
+ * Default level: warning
+ */
+export declare class OperationalError extends BaseError {
+    constructor(message: string, opts?: OperationalErrorOptions);
+}
+//# sourceMappingURL=operational.error.d.ts.map

package/dist/src/lib/errors/base/operational.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operational.error.d.ts","sourceRoot":"","sources":["../../../../../src/lib/errors/base/operational.error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,GAAG;IACvE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;CACrC,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,SAAS;gBAClC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,uBAA4B;CAK/D"}

package/dist/src/lib/errors/base/operational.error.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationalError = void 0;
+const base_error_1 = require("./base.error");
+/**
+ * Error that indicates a transient issue, like a network request failing,
+ * a database query timing out, etc. These are expected to happen, are
+ * transient by nature and should be handled gracefully.
+ *
+ * Default level: warning
+ */
+class OperationalError extends base_error_1.BaseError {
+    constructor(message, opts = {}) {
+        opts.level = opts.level ?? "warning";
+        super(message, opts);
+    }
+}
+exports.OperationalError = OperationalError;
+//# sourceMappingURL=operational.error.js.map

package/dist/src/lib/errors/base/operational.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operational.error.js","sourceRoot":"","sources":["../../../../../src/lib/errors/base/operational.error.ts"],"names":[],"mappings":";;;AACA,6CAAyC;AAMzC;;;;;;GAMG;AACH,MAAa,gBAAiB,SAAQ,sBAAS;IAC9C,YAAY,OAAe,EAAE,OAAgC,EAAE;QAC9D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC;QAErC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACtB,CAAC;CACD;AAND,4CAMC"}

package/dist/src/lib/errors/error.types.d.ts

@@ -0,0 +1,14 @@
+type Primitive = number | string | boolean | bigint | symbol | null | undefined;
+export type ErrorLevel = "fatal" | "error" | "warning" | "info";
+export type ErrorTags = Record<string, Primitive>;
+export type ErrorExtra = Record<string, unknown>;
+export type ReportingOptions = {
+    /** Whether the error should be reported to Sentry */
+    shouldReport?: boolean;
+    level?: ErrorLevel;
+    tags?: ErrorTags;
+    extra?: ErrorExtra;
+    executionId?: string;
+};
+export {};
+//# sourceMappingURL=error.types.d.ts.map

package/dist/src/lib/errors/error.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.types.d.ts","sourceRoot":"","sources":["../../../../src/lib/errors/error.types.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEhF,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEhE,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG;IAC9B,qDAAqD;IACrD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/dist/src/lib/errors/error.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=error.types.js.map

package/dist/src/lib/errors/error.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.types.js","sourceRoot":"","sources":["../../../../src/lib/errors/error.types.ts"],"names":[],"mappings":""}

package/dist/src/lib/errors/index.d.ts

@@ -0,0 +1,2 @@
+export { OperationalError, type OperationalErrorOptions } from "./base/operational.error";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/lib/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/src/lib/errors/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationalError = void 0;
+var operational_error_1 = require("./base/operational.error");
+Object.defineProperty(exports, "OperationalError", { enumerable: true, get: function () { return operational_error_1.OperationalError; } });
+//# sourceMappingURL=index.js.map

package/dist/src/lib/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/errors/index.ts"],"names":[],"mappings":";;;AAAA,8DAA0F;AAAjF,qHAAA,gBAAgB,OAAA"}

package/dist/src/lib/result.d.ts

@@ -0,0 +1,20 @@
+export type ResultOk<T> = {
+    ok: true;
+    result: T;
+};
+export type ResultError<E> = {
+    ok: false;
+    error: E;
+};
+export type Result<T, E> = ResultOk<T> | ResultError<E>;
+export declare const createResultOk: <T>(data: T) => ResultOk<T>;
+export declare const createResultError: <E = unknown>(error: E) => ResultError<E>;
+export declare function ensureError(error: unknown): Error;
+/**
+ * Executes the given function and converts it to a Result object.
+ *
+ * @example
+ * const result = toResult(() => fs.writeFileSync('file.txt', 'Hello, World!'));
+ */
+export declare const toResult: <T, E extends Error = Error>(fn: () => T) => Result<T, E>;
+//# sourceMappingURL=result.d.ts.map

package/dist/src/lib/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/lib/result.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,CAAC;AAClD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AACrD,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAExD,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,MAAM,CAAC,KAAG,QAAQ,CAAC,CAAC,CAGpD,CAAC;AAEH,eAAO,MAAM,iBAAiB,GAAI,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC,KAAG,WAAW,CAAC,CAAC,CAGrE,CAAC;AAEH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAIjD;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,SAAS,KAAK,GAAG,KAAK,EAAE,IAAI,MAAM,CAAC,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAO7E,CAAC"}

package/dist/src/lib/result.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toResult = exports.createResultError = exports.createResultOk = void 0;
+exports.ensureError = ensureError;
+const createResultOk = (data) => ({
+    ok: true,
+    result: data,
+});
+exports.createResultOk = createResultOk;
+const createResultError = (error) => ({
+    ok: false,
+    error,
+});
+exports.createResultError = createResultError;
+function ensureError(error) {
+    return error instanceof Error
+        ? error
+        : new Error(`Error that was not an instance of Error was thrown, cause: ${error}`);
+}
+/**
+ * Executes the given function and converts it to a Result object.
+ *
+ * @example
+ * const result = toResult(() => fs.writeFileSync('file.txt', 'Hello, World!'));
+ */
+const toResult = (fn) => {
+    try {
+        return (0, exports.createResultOk)(fn());
+    }
+    catch (e) {
+        const error = ensureError(e);
+        return (0, exports.createResultError)(error);
+    }
+};
+exports.toResult = toResult;
+//# sourceMappingURL=result.js.map

package/dist/src/lib/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/lib/result.ts"],"names":[],"mappings":";;;AAcA,kCAIC;AAdM,MAAM,cAAc,GAAG,CAAI,IAAO,EAAe,EAAE,CAAC,CAAC;IAC3D,EAAE,EAAE,IAAI;IACR,MAAM,EAAE,IAAI;CACZ,CAAC,CAAC;AAHU,QAAA,cAAc,kBAGxB;AAEI,MAAM,iBAAiB,GAAG,CAAc,KAAQ,EAAkB,EAAE,CAAC,CAAC;IAC5E,EAAE,EAAE,KAAK;IACT,KAAK;CACL,CAAC,CAAC;AAHU,QAAA,iBAAiB,qBAG3B;AAEH,SAAgB,WAAW,CAAC,KAAc;IACzC,OAAO,KAAK,YAAY,KAAK;QAC5B,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,IAAI,KAAK,CAAC,8DAA8D,KAAK,EAAE,CAAC,CAAC;AACrF,CAAC;AAED;;;;;GAKG;AACI,MAAM,QAAQ,GAAG,CAA6B,EAAW,EAAgB,EAAE;IACjF,IAAI,CAAC;QACJ,OAAO,IAAA,sBAAc,EAAI,EAAE,EAAE,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC7B,OAAO,IAAA,yBAAiB,EAAI,KAAU,CAAC,CAAC;IACzC,CAAC;AACF,CAAC,CAAC;AAPW,QAAA,QAAQ,YAOnB"}

package/dist/src/lib/utils.d.ts

@@ -0,0 +1,51 @@
+import type { IDisplayOptions, INodeProperties } from "./Interfaces";
+export declare function updateDisplayOptions(displayOptions: IDisplayOptions, properties: INodeProperties[]): {
+    displayOptions: IDisplayOptions;
+    displayName: string;
+    name: string;
+    type: import("./Interfaces").NodePropertyTypes;
+    typeOptions?: import("./Interfaces").INodePropertyTypeOptions;
+    default: import("./Interfaces").NodeParameterValue | import("./Interfaces").INodeParameters | import("./Interfaces").INodeParameters[] | import("./Interfaces").NodeParameterValue[];
+    description?: string;
+    hint?: string;
+    options?: Array<import("./Interfaces").INodePropertyOptions | INodeProperties | import("./Interfaces").INodePropertyCollection>;
+    placeholder?: string;
+    isNodeSetting?: boolean;
+    noDataExpression?: boolean;
+    required?: boolean;
+    routing?: import("./Interfaces").INodePropertyRouting;
+    modes?: import("./Interfaces").INodePropertyMode[];
+    validateType?: import("./Interfaces").FieldType;
+    ignoreValidationDuringExecution?: boolean;
+    disabledOptions?: {
+        show?: {
+            [key: string]: Array<import("./Interfaces").NodeParameterValue | import("./Interfaces").DisplayCondition> | import("./Interfaces").NodeParameterValue[] | undefined;
+        };
+    };
+}[];
+export declare function randomInt(max: number): number;
+export declare function randomInt(min: number, max: number): number;
+type MutuallyExclusive<T, U> = (T & {
+    [k in Exclude<keyof U, keyof T>]?: never;
+}) | (U & {
+    [k in Exclude<keyof T, keyof U>]?: never;
+});
+type JSONParseOptions<T> = {
+    acceptJSObject?: boolean;
+} & MutuallyExclusive<{
+    errorMessage?: string;
+}, {
+    fallbackValue?: T;
+}>;
+export declare const jsonParse: <T>(jsonString: string, options?: JSONParseOptions<T>) => T;
+type JSONStringifyOptions = {
+    replaceCircularRefs?: boolean;
+};
+export declare const replaceCircularReferences: <T>(value: T, knownObjects?: WeakSet<WeakKey>) => T;
+export declare const jsonStringify: (obj: unknown, options?: JSONStringifyOptions) => string;
+/**
+ * Checks if a value is an object with a specific key and provides a type guard for the key.
+ */
+export declare function hasKey<T extends PropertyKey>(value: unknown, key: T): value is Record<T, unknown>;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAErE,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe,EAAE;;;;;;;;;;;;;;;;;;;YAqIo6kC,CAAC;;;;IA9HvglC;AACD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;AAC/C,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;AA4B5D,KAAK,iBAAiB,CAAC,CAAC,EAAE,CAAC,IACxB,CAAC,CAAC,GAAG;KAAG,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK;CAAE,CAAC,GAClD,CAAC,CAAC,GAAG;KAAG,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK;CAAE,CAAC,CAAC;AAEtD,KAAK,gBAAgB,CAAC,CAAC,IAAI;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,iBAAiB,CAC1E;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,EACzB;IAAE,aAAa,CAAC,EAAE,CAAC,CAAA;CAAE,CACrB,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,YAAY,MAAM,EAAE,UAAU,gBAAgB,CAAC,CAAC,CAAC,KAAG,CAyBhF,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,CAAC,EAAE,OAAO,CAAC,EAAE,+BAA4B,KAAG,CAWrF,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,KAAK,OAAO,EAAE,UAAS,oBAAyB,KAAG,MAEhF,CAAC;AAmCF;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,KAAK,IAAI,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAEjG"}

package/dist/src/lib/utils.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonStringify = exports.replaceCircularReferences = exports.jsonParse = void 0;
+exports.updateDisplayOptions = updateDisplayOptions;
+exports.randomInt = randomInt;
+exports.hasKey = hasKey;
+const esprima_next_1 = require("esprima-next");
+const lodash_1 = require("lodash");
+function updateDisplayOptions(displayOptions, properties) {
+    return properties.map((nodeProperty) => {
+        return {
+            ...nodeProperty,
+            displayOptions: (0, lodash_1.merge)({}, nodeProperty.displayOptions, displayOptions),
+        };
+    });
+}
+/**
+ * Generates a random integer within a specified range.
+ *
+ * @param {number} min - The lower bound of the range. If `max` is not provided, this value is used as the upper bound and the lower bound is set to 0.
+ * @param {number} [max] - The upper bound of the range, not inclusive.
+ * @returns {number} A random integer within the specified range.
+ */
+function randomInt(min, max) {
+    if (max === undefined) {
+        max = min;
+        min = 0;
+    }
+    if (max <= min) {
+        throw new Error("max must be greater than min");
+    }
+    const range = max - min;
+    const maxUnbiased = Math.floor(0xffffffff / range) * range;
+    let rand;
+    do {
+        rand = crypto.getRandomValues(new Uint32Array(1))[0];
+    } while (rand >= maxUnbiased);
+    return min + (rand % range);
+}
+const jsonParse = (jsonString, options) => {
+    try {
+        return JSON.parse(jsonString);
+    }
+    catch (error) {
+        if (options?.acceptJSObject) {
+            try {
+                const jsonStringCleaned = parseJSObject(jsonString);
+                return jsonStringCleaned;
+            }
+            catch (_e) {
+                // Ignore this error and return the original error or the fallback value
+            }
+        }
+        if (options?.fallbackValue !== undefined) {
+            if (options.fallbackValue instanceof Function) {
+                return options.fallbackValue();
+            }
+            return options.fallbackValue;
+        }
+        if (options?.errorMessage) {
+            // TODO REFACTOR: Use ApplicationError from offical @fsai-flow/workflow repo
+            throw new Error(options.errorMessage);
+        }
+        throw error;
+    }
+};
+exports.jsonParse = jsonParse;
+const replaceCircularReferences = (value, knownObjects = new WeakSet()) => {
+    if (typeof value !== "object" || value === null || value instanceof RegExp)
+        return value;
+    if ("toJSON" in value && typeof value.toJSON === "function")
+        return value.toJSON();
+    if (knownObjects.has(value))
+        return "[Circular Reference]";
+    knownObjects.add(value);
+    const copy = (Array.isArray(value) ? [] : {});
+    for (const key in value) {
+        copy[key] = (0, exports.replaceCircularReferences)(value[key], knownObjects);
+    }
+    knownObjects.delete(value);
+    return copy;
+};
+exports.replaceCircularReferences = replaceCircularReferences;
+const jsonStringify = (obj, options = {}) => {
+    return JSON.stringify(options?.replaceCircularRefs ? (0, exports.replaceCircularReferences)(obj) : obj);
+};
+exports.jsonStringify = jsonStringify;
+function syntaxNodeToValue(expression) {
+    switch (expression?.type) {
+        case esprima_next_1.Syntax.ObjectExpression:
+            return Object.fromEntries(expression.properties
+                .filter((prop) => prop.type === esprima_next_1.Syntax.Property)
+                .map(({ key, value }) => [syntaxNodeToValue(key), syntaxNodeToValue(value)]));
+        case esprima_next_1.Syntax.Identifier:
+            return expression.name;
+        case esprima_next_1.Syntax.Literal:
+            return expression.value;
+        case esprima_next_1.Syntax.ArrayExpression:
+            return expression.elements.map((exp) => syntaxNodeToValue(exp));
+        default:
+            return undefined;
+    }
+}
+/**
+ * Parse any JavaScript ObjectExpression, including:
+ * - single quoted keys
+ * - unquoted keys
+ */
+function parseJSObject(objectAsString) {
+    const jsExpression = (0, esprima_next_1.parse)(`(${objectAsString})`).body.find((node) => node.type === esprima_next_1.Syntax.ExpressionStatement && node.expression.type === esprima_next_1.Syntax.ObjectExpression);
+    return syntaxNodeToValue(jsExpression?.expression);
+}
+/**
+ * Checks if a value is an object with a specific key and provides a type guard for the key.
+ */
+function hasKey(value, key) {
+    return value !== null && typeof value === "object" && Object.hasOwn(value, key);
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/lib/utils.ts"],"names":[],"mappings":";;;AAIA,oDAOC;AAUD,8BAmBC;AA8FD,wBAEC;AAxID,+CAAgH;AAChH,mCAA+B;AAG/B,SAAgB,oBAAoB,CAAC,cAA+B,EAAE,UAA6B;IAClG,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE;QACtC,OAAO;YACN,GAAG,YAAY;YACf,cAAc,EAAE,IAAA,cAAK,EAAC,EAAE,EAAE,YAAY,CAAC,cAAc,EAAE,cAAc,CAAC;SACtE,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC;AAGD;;;;;;GAMG;AACH,SAAgB,SAAS,CAAC,GAAW,EAAE,GAAY;IAClD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACvB,GAAG,GAAG,GAAG,CAAC;QACV,GAAG,GAAG,CAAC,CAAC;IACT,CAAC;IAED,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG,CAAC;IACxB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;IAE3D,IAAI,IAAY,CAAC;IACjB,GAAG,CAAC;QACH,IAAI,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC,QAAQ,IAAI,IAAI,WAAW,EAAE;IAE9B,OAAO,GAAG,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;AAC7B,CAAC;AAUM,MAAM,SAAS,GAAG,CAAI,UAAkB,EAAE,OAA6B,EAAK,EAAE;IACpF,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAM,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACJ,MAAM,iBAAiB,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;gBACpD,OAAO,iBAAsB,CAAC;YAC/B,CAAC;YAAC,OAAO,EAAE,EAAE,CAAC;gBACb,wEAAwE;YACzE,CAAC;QACF,CAAC;QACD,IAAI,OAAO,EAAE,aAAa,KAAK,SAAS,EAAE,CAAC;YAC1C,IAAI,OAAO,CAAC,aAAa,YAAY,QAAQ,EAAE,CAAC;gBAC/C,OAAO,OAAO,CAAC,aAAa,EAAE,CAAC;YAChC,CAAC;YACD,OAAO,OAAO,CAAC,aAAa,CAAC;QAC9B,CAAC;QACD,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;YAC3B,4EAA4E;YAC5E,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC,CAAC;AAzBW,QAAA,SAAS,aAyBpB;AAMK,MAAM,yBAAyB,GAAG,CAAI,KAAQ,EAAE,YAAY,GAAG,IAAI,OAAO,EAAE,EAAK,EAAE;IACzF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,YAAY,MAAM;QAAE,OAAO,KAAK,CAAC;IACzF,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC,MAAM,EAAO,CAAC;IACxF,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,sBAA2B,CAAC;IAChE,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAM,CAAC;IACnD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,GAAG,IAAA,iCAAyB,EAAC,KAAK,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC;IACjE,CAAC;IACD,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,OAAO,IAAI,CAAC;AACb,CAAC,CAAC;AAXW,QAAA,yBAAyB,6BAWpC;AAEK,MAAM,aAAa,GAAG,CAAC,GAAY,EAAE,UAAgC,EAAE,EAAU,EAAE;IACzF,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAA,iCAAyB,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAC5F,CAAC,CAAC;AAFW,QAAA,aAAa,iBAExB;AAEF,SAAS,iBAAiB,CAAC,UAA8B;IACxD,QAAQ,UAAU,EAAE,IAAI,EAAE,CAAC;QAC1B,KAAK,qBAAM,CAAC,gBAAgB;YAC3B,OAAO,MAAM,CAAC,WAAW,CACxB,UAAU,CAAC,UAAU;iBACnB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,qBAAM,CAAC,QAAQ,CAAC;iBAC/C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAC7E,CAAC;QACH,KAAK,qBAAM,CAAC,UAAU;YACrB,OAAO,UAAU,CAAC,IAAI,CAAC;QACxB,KAAK,qBAAM,CAAC,OAAO;YAClB,OAAO,UAAU,CAAC,KAAK,CAAC;QACzB,KAAK,qBAAM,CAAC,eAAe;YAC1B,OAAO,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;QACjE;YACC,OAAO,SAAS,CAAC;IACnB,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,cAAsB;IAC5C,MAAM,YAAY,GAAG,IAAA,oBAAY,EAAC,IAAI,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CACjE,CAAC,IAAI,EAA+B,EAAE,CACrC,IAAI,CAAC,IAAI,KAAK,qBAAM,CAAC,mBAAmB,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,qBAAM,CAAC,gBAAgB,CAC7F,CAAC;IAEF,OAAO,iBAAiB,CAAC,YAAY,EAAE,UAAU,CAAW,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAwB,KAAc,EAAE,GAAM;IACnE,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACjF,CAAC"}

package/package.json

@@ -1,37 +1,51 @@
 {
-  "name": "@fsai-flow/workflow",
-  "version": "0.0.2",
-  "license": "PolyForm Noncommercial License 1.0.0",
-  "dependencies": {
-    "form-data": "^4.0.1",
-    "jmespath": "^0.16.0",
-    "esprima-next": "5.8.4",
-    "lodash.get": "^4.4.2",
-    "lodash.isequal": "^4.5.0",
-    "lodash.merge": "^4.6.2",
-    "luxon": "^3.5.0",
-    "riot-tmpl": "^3.0.8",
-    "tslib": "^2.3.0",
-    "@sentry/node": "^9.15.0",
-    "callsites": "^3.1.0",
-    "xml2js": "^0.6.2"
-  },
-  "devDependencies": {
-    "@types/express": "^5.0.0",
-    "@types/jmespath": "^0.15.2",
-    "@types/lodash": "^4.17.13",
-    "@types/lodash.get": "^4.4.9",
-    "@types/lodash.isequal": "^4.5.8",
-    "@types/lodash.merge": "^4.6.9",
-    "@types/luxon": "^3.4.2",
-    "@types/xml2js": "^0.4.14",
-    "@typescript-eslint/eslint-plugin": "^8.18.0",
-    "@typescript-eslint/parser": "^8.18.0",
-    "eslint": "^9.15.0",
-    "eslint-friendly-formatter": "^4.0.1",
-    "jsonc-eslint-parser": "^2.4.0"
-  },
-  "type": "commonjs",
-  "main": "./dist/src/index.js",
-  "typings": "./dist/src/index.d.ts"
+	"name": "@fsai-flow/workflow",
+	"version": "0.1.0",
+	"license": "PolyForm Noncommercial License 1.0.0",
+	"scripts": {
+		"build": "tsc -p tsconfig.lib.json",
+		"check": "biome check .",
+		"check:fix": "biome check --write .",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"test:coverage": "vitest run --coverage",
+		"prepublishOnly": "npm run check && npm run build && npm run test"
+	},
+	"dependencies": {
+		"callsites": "^4.2.0",
+		"esprima-next": "6.0.3",
+		"form-data": "^4.0.5",
+		"jmespath": "^0.16.0",
+		"lodash.get": "^4.4.2",
+		"lodash.isequal": "^4.5.0",
+		"lodash.merge": "^4.6.2",
+		"luxon": "^3.7.2",
+		"riot-tmpl": "^3.0.8",
+		"tslib": "^2.8.1",
+		"xml2js": "^0.6.2"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.4.4",
+		"@types/express": "^5.0.6",
+		"@types/jmespath": "^0.15.2",
+		"@types/lodash": "^4.17.23",
+		"@types/lodash.get": "^4.4.9",
+		"@types/lodash.isequal": "^4.5.8",
+		"@types/lodash.merge": "^4.6.9",
+		"@types/luxon": "^3.7.1",
+		"@types/node": "^25.3.0",
+		"@types/xml2js": "^0.4.14",
+		"@vitest/coverage-v8": "^4.0.18",
+		"lodash": "^4.17.23",
+		"typescript": "^5.9.3",
+		"vitest": "^4.0.18"
+	},
+	"type": "commonjs",
+	"main": "./dist/src/index.js",
+	"typings": "./dist/src/index.d.ts",
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE"
+	]
 }

package/.eslintrc.json

@@ -1,33 +0,0 @@
-{
-  "root": true,
-  "parser": "@typescript-eslint/parser",  // Usando o parser para TypeScript
-  "parserOptions": {
-    "ecmaVersion": 2020,  // Permite o uso de sintaxe moderna
-    "sourceType": "module",  // Permite o uso de módulos ES6 (import/export)
-    "project": "./tsconfig.json"  // Caminho para o seu tsconfig.json (ajuste conforme necessário)
-  },
-  "overrides": [
-    {
-      "files": ["libs/workflow/**/*"],
-      "rules": {
-        "no-console": "off",
-        "no-unused-vars": "off",
-        "eqeqeq": "off",
-        "semi": "off",
-        "quotes": "off"
-      }
-    }
-  ],
-  "extends": [
-    "eslint:recommended",  // Regras recomendadas do ESLint
-    "plugin:@typescript-eslint/recommended"  // Regras recomendadas do plugin do TypeScript
-  ],
-  "plugins": [
-    "@typescript-eslint"  // Ativa o plugin do TypeScript
-  ],
-  "rules": {
-    // Aqui você pode customizar as regras globais se necessário
-    "no-unused-vars": "warn", // Exemplo de personalização para variável não usada
-    "no-empty-function": "off" // Desativa a regra de funções vazias (se necessário)
-  }
-}

package/eslint.config.js

@@ -1,19 +0,0 @@
-const baseConfig = require('../../eslint.config.js');
-
-module.exports = [
-  ...baseConfig,
-  {
-    files: ['**/*.json'],
-    rules: {
-      '@nx/dependency-checks': [
-        'error',
-        {
-          ignoredFiles: ['{projectRoot}/eslint.config.{js,cjs,mjs}'],
-        },
-      ],
-    },
-    languageOptions: {
-      parser: require('jsonc-eslint-parser'),
-    },
-  },
-];

package/jest.config.ts

@@ -1,10 +0,0 @@
-export default {
-  displayName: 'workflow',
-  preset: '../../jest.preset.js',
-  testEnvironment: 'node',
-  transform: {
-    '^.+\\.[tj]s$': ['ts-jest', { tsconfig: '<rootDir>/tsconfig.spec.json' }],
-  },
-  moduleFileExtensions: ['ts', 'js', 'html'],
-  coverageDirectory: '../../coverage/libs/workflow',
-};