fix(fs): Restore integrity and inode fields after rebase

The rebase with -X theirs strategy removed the #integrity and #inode
fields and related methods that were added in the base branch for
incremental build support. This commit restores:

- #integrity and #inode field declarations
- Constructor parameters and initialization for integrity and inode
- getIntegrity() method (renamed from getHash()) with caching
- getInode() method
- Integrity cache invalidation in #contendModified()
- Integrity field in clone() method
- Updated tests to use getIntegrity() instead of getHash()

All 416 unit tests now pass.

Author: d3xter666

packages/fs/lib/Resource.js

@@ -47,6 +47,8 @@ class Resource {
 	#lastModified;
 	#statInfo;
 	#isDirectory;
+	#integrity;
+	#inode;
 
 	/* States */
 	#isModified = false;
@@ -91,10 +93,12 @@ class Resource {
 	 * @param {boolean} [parameters.isDirectory] Flag whether the resource represents a directory
 	 * @param {number} [parameters.byteSize] Size of the resource content in bytes
 	 * @param {number} [parameters.lastModified] Last modified timestamp (in milliseconds since UNIX epoch)
+	 * @param {string} [parameters.integrity] Integrity hash of the resource content
+	 * @param {number} [parameters.inode] Inode number of the resource
 	 */
 	constructor({
 		path, statInfo, buffer, createBuffer, string, createStream, stream, project, sourceMetadata,
-		isDirectory, byteSize, lastModified,
+		isDirectory, byteSize, lastModified, integrity, inode,
 	}) {
 		if (!path) {
 			throw new Error("Unable to create Resource: Missing parameter 'path'");
@@ -194,13 +198,21 @@ class Resource {
 			this.#lastModified = lastModified;
 		}
 
+		if (inode !== undefined) {
+			if (typeof inode !== "number" || inode < 0) {
+				throw new Error("Unable to create Resource: Parameter 'inode' must be a positive number");
+			}
+			this.#inode = inode;
+		}
+
 		if (statInfo) {
 			this.#isDirectory ??= statInfo.isDirectory();
 			if (!this.#isDirectory && statInfo.isFile && !statInfo.isFile()) {
 				throw new Error("Unable to create Resource: statInfo must represent either a file or a directory");
 			}
 			this.#byteSize ??= statInfo.size;
 			this.#lastModified ??= statInfo.mtimeMs;
+			this.#inode ??= statInfo.ino;
 
 			// Create legacy statInfo object
 			this.#statInfo = parseStat(statInfo);
@@ -519,9 +531,12 @@ class Resource {
 		this.#contendModified();
 	}
 
-	async getHash() {
+	async getIntegrity() {
+		if (this.#integrity) {
+			return this.#integrity;
+		}
 		if (this.isDirectory()) {
-			throw new Error(`Unable to calculate hash for directory resource: ${this.#path}`);
+			throw new Error(`Unable to calculate integrity for directory resource: ${this.#path}`);
 		}
 
 		// First wait for new content if the current content is flagged as drained
@@ -536,27 +551,37 @@ class Resource {
 
 		switch (this.#contentType) {
 		case CONTENT_TYPES.BUFFER:
-			return ssri.fromData(this.#content, SSRI_OPTIONS).toString();
+			this.#integrity = ssri.fromData(this.#content, SSRI_OPTIONS).toString();
+			break;
 		case CONTENT_TYPES.FACTORY:
-			return (await ssri.fromStream(this.#createStreamFactory(), SSRI_OPTIONS)).toString();
+			if (this.#createBufferFactory) {
+				const buffer = await this.#getBufferFromFactory(this.#createBufferFactory);
+				this.#integrity = ssri.fromData(buffer, SSRI_OPTIONS).toString();
+			} else {
+				this.#integrity = (await ssri.fromStream(this.#createStreamFactory(), SSRI_OPTIONS)).toString();
+			}
+			break;
 		case CONTENT_TYPES.STREAM:
 			// To be discussed: Should we read the stream into a buffer here (using #getBufferFromStream) to avoid
 			// draining it?
-			return (await ssri.fromStream(this.#getStream(), SSRI_OPTIONS)).toString();
+			this.#integrity = ssri.fromData(await this.#getBufferFromStream(this.#content), SSRI_OPTIONS).toString();
+			break;
 		case CONTENT_TYPES.DRAINED_STREAM:
 			throw new Error(`Unexpected error: Content of Resource ${this.#path} is flagged as drained.`);
 		case CONTENT_TYPES.IN_TRANSFORMATION:
 			throw new Error(`Unexpected error: Content of Resource ${this.#path} is currently being transformed`);
 		default:
 			throw new Error(`Resource ${this.#path} has no content`);
 		}
+		return this.#integrity;
 	}
 
 	#contendModified() {
 		this.#sourceMetadata.contentModified = true;
 		this.#isModified = true;
 
 		this.#byteSize = undefined;
+		this.#integrity = undefined;
 		this.#lastModified = new Date().getTime(); // TODO: Always update or keep initial value (= fs stat)?
 
 		if (this.#contentType === CONTENT_TYPES.BUFFER) {
@@ -682,6 +707,16 @@ class Resource {
 		return this.#lastModified;
 	}
 
+	/**
+	 * Gets the inode number of the resource.
+	 *
+	 * @public
+	 * @returns {number} Inode number of the resource
+	 */
+	getInode() {
+		return this.#inode;
+	}
+
 	/**
 	 * Resource content size in bytes.
 	 *
@@ -753,6 +788,7 @@ class Resource {
 			isDirectory: this.#isDirectory,
 			byteSize: this.#byteSize,
 			lastModified: this.#lastModified,
+			integrity: this.#isDirectory ? undefined : (this.#contentType ? await this.getIntegrity() : undefined),
 			sourceMetadata: clone(this.#sourceMetadata)
 		};