first commit

packages/@n8n/errors/eslint.config.mjs

@@ -0,0 +1,8 @@
+import { defineConfig } from 'eslint/config';
+import { baseConfig } from '@n8n/eslint-config/base';
+
+export default defineConfig(baseConfig, {
+	rules: {
+		'unicorn/filename-case': ['error', { case: 'kebabCase' }],
+	},
+});

packages/@n8n/errors/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@n8n/errors",
+  "version": "0.6.0",
+  "scripts": {
+    "clean": "rimraf dist .turbo",
+    "dev": "pnpm watch",
+    "typecheck": "tsc --noEmit",
+    "build": "tsc -p tsconfig.build.json",
+    "format": "biome format --write .",
+    "format:check": "biome ci .",
+    "lint": "eslint . --quiet",
+    "lint:fix": "eslint . --fix",
+    "watch": "tsc -p tsconfig.build.json --watch",
+    "test": "echo \"WARNING: no test specified\" && exit 0",
+    "test:dev": "echo \"WARNING: no test specified\" && exit 0"
+  },
+  "main": "dist/index.js",
+  "module": "src/index.ts",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*"
+  ],
+  "devDependencies": {
+    "@n8n/typescript-config": "workspace:*",
+    "@sentry/node": "catalog:sentry"
+  },
+  "dependencies": {
+    "callsites": "catalog:"
+  }
+}

packages/@n8n/errors/src/application.error.ts

@@ -0,0 +1,36 @@
+import type { Event } from '@sentry/node';
+import callsites from 'callsites';
+
+import type { ErrorLevel, ReportingOptions } from './types';
+
+/**
+ * @deprecated Use `UserError`, `OperationalError` or `UnexpectedError` instead.
+ */
+export class ApplicationError extends Error {
+	level: ErrorLevel;
+
+	readonly tags: NonNullable<Event['tags']>;
+
+	readonly extra?: Event['extra'];
+
+	readonly packageName?: string;
+
+	constructor(
+		message: string,
+		{ level, tags = {}, extra, ...rest }: ErrorOptions & ReportingOptions = {},
+	) {
+		super(message, rest);
+		this.level = level ?? 'error';
+		this.tags = tags;
+		this.extra = extra;
+
+		try {
+			const filePath = callsites()[2].getFileName() ?? '';
+			// eslint-disable-next-line no-useless-escape
+			const match = /packages\/([^\/]+)\//.exec(filePath)?.[1];
+
+			if (match) this.tags.packageName = match;
+			// eslint-disable-next-line no-empty
+		} catch {}
+	}
+}

packages/@n8n/errors/src/index.ts

@@ -0,0 +1,2 @@
+export { ApplicationError } from './application.error';
+export type * from './types';

packages/@n8n/errors/src/types.ts

@@ -0,0 +1,16 @@
+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;
+	/** Whether the error log should be logged (default to true) */
+	shouldBeLogged?: boolean;
+	level?: ErrorLevel;
+	tags?: ErrorTags;
+	extra?: Event['extra'];
+	executionId?: string;
+};

packages/@n8n/errors/tsconfig.build.json

@@ -0,0 +1,11 @@
+{
+	"extends": ["./tsconfig.json", "@n8n/typescript-config/tsconfig.build.json"],
+	"compilerOptions": {
+		"composite": true,
+		"rootDir": "src",
+		"outDir": "dist",
+		"tsBuildInfoFile": "dist/build.tsbuildinfo"
+	},
+	"include": ["src/**/*.ts"],
+	"exclude": ["src/**/__tests__/**"]
+}

packages/@n8n/errors/tsconfig.json

@@ -0,0 +1,12 @@
+{
+	"extends": "@n8n/typescript-config/tsconfig.common.json",
+	"compilerOptions": {
+		"rootDir": ".",
+		"types": ["node", "jest"],
+		"baseUrl": "src",
+		"tsBuildInfoFile": "dist/typecheck.tsbuildinfo",
+		"experimentalDecorators": true,
+		"emitDecoratorMetadata": true
+	},
+	"include": ["src/**/*.ts"]
+}