@fsai-flow/workflow 0.0.1

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,iHAAiH;IACjH,KAAK,CAAC,oBAAoB,CAAC,QAAgB,EAAE,UAAiB;QAC7D,6BAA6B;QAC7B,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,UAAU,CAAC,CAAC;YAC5C,CAAC;QACF,CAAC;IACF,CAAC;CACD;AA1CD,sCA0CC"}

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

@@ -0,0 +1,30 @@
+import type { Event } from '@sentry/node';
+import type { ErrorTags, ErrorLevel, 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?: Event['extra'];
+    readonly packageName?: string;
+    readonly cause?: unknown;
+    constructor(message: string, { level, description, shouldReport, tags, extra, ...rest }?: BaseErrorOptions);
+}
+export {};

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

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseError = void 0;
+const tslib_1 = require("tslib");
+const callsites_1 = tslib_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":";;;;AACA,kEAAkC;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,CAAkB;IAEvB,WAAW,CAAU;IAErB,KAAK,CAAW;IAEzB,YACC,OAAe,EACf,EACC,KAAK,GAAG,OAAO,EACf,WAAW,EACX,YAAY,EACZ,IAAI,GAAG,EAAE,EACT,KAAK,EACL,GAAG,IAAI,KACc,EAAE;QAExB,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,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAEzD,IAAI,KAAK;gBAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACX,CAAC;CACD;AArDD,8BAqDC"}

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

@@ -0,0 +1,15 @@
+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);
+}

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,11 @@
+import type { Event } from '@sentry/node';
+export type ErrorLevel = 'fatal' | 'error' | 'warning' | 'info';
+export type ErrorTags = NonNullable<Event['tags']>;
+export type ReportingOptions = {
+    /** Whether the error should be reported to Sentry */
+    shouldReport?: boolean;
+    level?: ErrorLevel;
+    tags?: ErrorTags;
+    extra?: Event['extra'];
+    executionId?: string;
+};

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 @@
+export { OperationalError, type OperationalErrorOptions } from './base/operational.error';

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,19 @@
+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>;

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,6DAA6D,GAAG,KAAK,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,50 @@
+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<object>) => 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 {};

package/dist/src/lib/utils.js

@@ -0,0 +1,110 @@
+"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;
+    }
+    return min + (crypto.getRandomValues(new Uint32Array(1))[0] % (max - min));
+}
+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;
+        }
+        else 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' && value.hasOwnProperty(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":"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"}

package/eslint.config.js

@@ -0,0 +1,19 @@
+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

@@ -0,0 +1,10 @@
+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',
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@fsai-flow/workflow",
+  "version": "0.0.1",
+  "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"
+  },
+  "scripts": {
+    "release": "npm build && npm publish --access public"
+  },
+  "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"
+}

package/project.json

@@ -0,0 +1,19 @@
+{
+  "name": "workflow",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "libs/workflow/src",
+  "projectType": "library",
+  "tags": [],
+  "targets": {
+    "build": {
+      "executor": "@nx/js:tsc",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "libs/workflow/dist",
+        "main": "libs/workflow/src/index.ts",
+        "tsConfig": "libs/workflow/tsconfig.lib.json",
+        "assets": ["libs/workflow/*.md"]
+      }
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,33 @@
+import * as LoggerProxy from './lib/LoggerProxy';
+import * as NodeHelpers from './lib/NodeHelpers';
+import * as ObservableObject from './lib/ObservableObject';
+
+export * from './lib/MetadataUtils';
+
+export * from './lib/errors'
+export * from './lib/DeferredPromise';
+export * from './lib/Interfaces';
+export * from './lib/Expression';
+export * from './lib/NodeErrors';
+export * from './lib/Constants';
+export * from './lib/NodeHelpers';
+export * as TelemetryHelpers from './lib/TelemetryHelpers';
+export * from './lib/RoutingNode';
+export * from './lib/Workflow';
+export * from './lib/TypeValidation';
+export * from './lib/WorkflowDataProxy';
+export * from './lib/WorkflowErrors';
+export * from './lib/WorkflowHooks';
+export * from './lib/result';
+export {
+    LoggerProxy,
+    NodeHelpers,
+    ObservableObject
+};
+export {
+    updateDisplayOptions,
+    randomInt,
+    jsonParse,
+    jsonStringify,
+    replaceCircularReferences,
+} from './lib/utils';

package/src/lib/Constants.ts

@@ -0,0 +1,124 @@
+import { NodeConnectionType, NodeConnectionTypes } from "./Interfaces";
+
+export const DIGITS = '0123456789';
+export const UPPERCASE_LETTERS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+export const LOWERCASE_LETTERS = UPPERCASE_LETTERS.toLowerCase();
+export const ALPHABET = [DIGITS, UPPERCASE_LETTERS, LOWERCASE_LETTERS].join('');
+
+export const BINARY_ENCODING = 'base64';
+export const WAIT_INDEFINITELY = new Date('3000-01-01T00:00:00.000Z');
+
+export const LOG_LEVELS = ['silent', 'error', 'warn', 'info', 'debug'] as const;
+
+export const CODE_LANGUAGES = ['javaScript', 'python'] as const;
+export const CODE_EXECUTION_MODES = ['runOnceForAllItems', 'runOnceForEachItem'] as const;
+
+// Arbitrary value to represent an empty credential value
+export const CREDENTIAL_EMPTY_VALUE = '__n8n_EMPTY_VALUE_7b1af746-3729-4c60-9b9b-e08eb29e58da';
+
+export const FORM_TRIGGER_PATH_IDENTIFIER = 'n8n-form';
+
+export const UNKNOWN_ERROR_MESSAGE = 'There was an unknown issue while executing the node';
+export const UNKNOWN_ERROR_DESCRIPTION =
+	'Double-check the node configuration and the service it connects to. Check the error details below and refer to the <a href="https://docs.n8n.io" target="_blank">n8n documentation</a> to troubleshoot the issue.';
+export const UNKNOWN_ERROR_MESSAGE_CRED = 'UNKNOWN ERROR';
+
+//n8n-nodes-base
+export const STICKY_NODE_TYPE = 'n8n-nodes-base.stickyNote';
+export const NO_OP_NODE_TYPE = 'n8n-nodes-base.noOp';
+export const HTTP_REQUEST_NODE_TYPE = 'n8n-nodes-base.httpRequest';
+export const WEBHOOK_NODE_TYPE = 'n8n-nodes-base.webhook';
+export const MANUAL_TRIGGER_NODE_TYPE = 'n8n-nodes-base.manualTrigger';
+export const ERROR_TRIGGER_NODE_TYPE = 'n8n-nodes-base.errorTrigger';
+export const START_NODE_TYPE = 'n8n-nodes-base.start';
+export const EXECUTE_WORKFLOW_NODE_TYPE = 'n8n-nodes-base.executeWorkflow';
+export const EXECUTE_WORKFLOW_TRIGGER_NODE_TYPE = 'n8n-nodes-base.executeWorkflowTrigger';
+export const CODE_NODE_TYPE = 'n8n-nodes-base.code';
+export const FUNCTION_NODE_TYPE = 'n8n-nodes-base.function';
+export const FUNCTION_ITEM_NODE_TYPE = 'n8n-nodes-base.functionItem';
+export const MERGE_NODE_TYPE = 'n8n-nodes-base.merge';
+export const AI_TRANSFORM_NODE_TYPE = 'n8n-nodes-base.aiTransform';
+export const FORM_NODE_TYPE = 'n8n-nodes-base.form';
+export const FORM_TRIGGER_NODE_TYPE = 'n8n-nodes-base.formTrigger';
+export const CHAT_TRIGGER_NODE_TYPE = '@n8n/n8n-nodes-langchain.chatTrigger';
+export const WAIT_NODE_TYPE = 'n8n-nodes-base.wait';
+
+export const ConnectionTypeDisplayNames: { [key in NodeConnectionType]: string } = {
+	[NodeConnectionTypes.Main]: 'Main',
+	[NodeConnectionTypes.AiAgent]: 'IA Agent',
+	[NodeConnectionTypes.AiChain]: 'Chain',
+	[NodeConnectionTypes.AiDocument]: 'Document',
+	[NodeConnectionTypes.AiEmbedding]: 'Embedding',
+	[NodeConnectionTypes.AiLanguageModel]: 'Model',
+	[NodeConnectionTypes.AiMemory]: 'Memory',
+	[NodeConnectionTypes.AiOutputParser]: 'Output Parser',
+	[NodeConnectionTypes.AiRetriever]: 'Retriever',
+	[NodeConnectionTypes.AiTextSplitter]: 'Text Splitter',
+	[NodeConnectionTypes.AiTool]: 'Tool',
+	[NodeConnectionTypes.AiVectorStore]: 'Vector Store',
+};
+
+export const STARTING_NODE_TYPES = [
+	MANUAL_TRIGGER_NODE_TYPE,
+	EXECUTE_WORKFLOW_TRIGGER_NODE_TYPE,
+	ERROR_TRIGGER_NODE_TYPE,
+	START_NODE_TYPE,
+];
+
+export const SCRIPTING_NODE_TYPES = [
+	FUNCTION_NODE_TYPE,
+	FUNCTION_ITEM_NODE_TYPE,
+	CODE_NODE_TYPE,
+	AI_TRANSFORM_NODE_TYPE,
+];
+
+export const ADD_FORM_NOTICE = 'addFormPage';
+
+/**
+ * Nodes whose parameter values may refer to other nodes without expressions.
+ * Their content may need to be updated when the referenced node is renamed.
+ */
+export const NODES_WITH_RENAMABLE_CONTENT = new Set([
+	CODE_NODE_TYPE,
+	FUNCTION_NODE_TYPE,
+	FUNCTION_ITEM_NODE_TYPE,
+	AI_TRANSFORM_NODE_TYPE,
+]);
+
+//@n8n/n8n-nodes-langchain
+export const MANUAL_CHAT_TRIGGER_LANGCHAIN_NODE_TYPE = '@n8n/n8n-nodes-langchain.manualChatTrigger';
+export const AGENT_LANGCHAIN_NODE_TYPE = '@n8n/n8n-nodes-langchain.agent';
+export const CHAIN_LLM_LANGCHAIN_NODE_TYPE = '@n8n/n8n-nodes-langchain.chainLlm';
+export const OPENAI_LANGCHAIN_NODE_TYPE = '@n8n/n8n-nodes-langchain.openAi';
+export const CHAIN_SUMMARIZATION_LANGCHAIN_NODE_TYPE =
+	'@n8n/n8n-nodes-langchain.chainSummarization';
+export const CODE_TOOL_LANGCHAIN_NODE_TYPE = '@n8n/n8n-nodes-langchain.toolCode';
+export const WORKFLOW_TOOL_LANGCHAIN_NODE_TYPE = '@n8n/n8n-nodes-langchain.toolWorkflow';
+export const HTTP_REQUEST_TOOL_LANGCHAIN_NODE_TYPE = '@n8n/n8n-nodes-langchain.toolHttpRequest';
+
+export const LANGCHAIN_CUSTOM_TOOLS = [
+	CODE_TOOL_LANGCHAIN_NODE_TYPE,
+	WORKFLOW_TOOL_LANGCHAIN_NODE_TYPE,
+	HTTP_REQUEST_TOOL_LANGCHAIN_NODE_TYPE,
+];
+
+export const SEND_AND_WAIT_OPERATION = 'sendAndWait';
+export const AI_TRANSFORM_CODE_GENERATED_FOR_PROMPT = 'codeGeneratedForPrompt';
+export const AI_TRANSFORM_JS_CODE = 'jsCode';
+
+/**
+ * Key for an item standing in for a manual execution data item too large to be
+ * sent live via pubsub. See {@link TRIMMED_TASK_DATA_CONNECTIONS} in constants
+ * in `cli` package.
+ */
+export const TRIMMED_TASK_DATA_CONNECTIONS_KEY = '__isTrimmedManualExecutionDataItem';
+
+export const OPEN_AI_API_CREDENTIAL_TYPE = 'openAiApi';
+export const FREE_AI_CREDITS_ERROR_TYPE = 'free_ai_credits_request_error';
+export const FREE_AI_CREDITS_USED_ALL_CREDITS_ERROR_CODE = 400;
+
+export const FROM_AI_AUTO_GENERATED_MARKER = '/*n8n-auto-generated-fromAI-override*/';
+
+export const PROJECT_ROOT = '0';
+
+export const WAITING_FORMS_EXECUTION_STATUS = 'n8n-execution-status';