xrootd 0.1.11 → 0.2.0

package/dist/index.mjs

@@ -119,13 +119,20 @@ var File = class {
 	async read(offset, size) {
 		return this._internal.Read(BigInt(offset), size);
 	}
+	async write(offset, arg1, arg2, arg3) {
+		if (Buffer.isBuffer(arg1)) return this._internal.Write(BigInt(offset), arg1);
+		else if (typeof arg1 === "number" && typeof arg2 === "number") return this._internal.WriteFd(BigInt(offset), arg1, arg2, arg3 !== void 0 ? BigInt(arg3) : void 0);
+		else throw new TypeError("Invalid arguments for write");
+	}
 	/**
-	* 写入文件块
-	* @param offset 偏移量
-	* @param buffer 要写入的数据
+	* 从本地 fd 写入文件块 (直接映射)
+	* @param offset 写入的起始字节偏移量。
+	* @param size 写入大小。
+	* @param fd 本地文件描述符 (fd)。
+	* @param fdoff 可选，从本地 fd 中读取的起始偏移。
 	*/
-	async write(offset, buffer) {
-		return this._internal.Write(BigInt(offset), buffer);
+	async writeFd(offset, size, fd, fdoff) {
+		return this._internal.WriteFd(BigInt(offset), size, fd, fdoff !== void 0 ? BigInt(fdoff) : void 0);
 	}
 	/**
 	* 同步文件缓冲区到磁盘
@@ -147,7 +154,9 @@ var File = class {
 		return this._internal.IsOpen();
 	}
 	async getProperty(name) {
-		return this._internal.GetProperty(name);
+		const ret = this._internal.GetProperty(name);
+		if (ret.success) return ret.value;
+		throw new Error("TODO");
 	}
 	async setProperty(name, value) {
 		return this._internal.SetProperty(name, value);
@@ -179,25 +188,37 @@ var File = class {
 	/**
 	* 设置文件的扩展属性
 	*/
-	async setXAttr(name, value) {
-		return this._internal.SetXAttr(name);
+	async setXAttrs(attrs) {
+		return this._internal.SetXAttr(attrs);
+	}
+	/**
+	* 设置文件的扩展属性
+	*/
+	async setXAttr(key, value) {
+		return (await this._internal.SetXAttr({ [key]: value }))[0].ok;
 	}
 	/**
 	* 获取文件的扩展属性
 	*/
-	async getXAttr(name) {
-		return this._internal.GetXAttr(name);
+	async getXAttrs(keys) {
+		return this._internal.GetXAttr(keys);
+	}
+	async getXAttr(key) {
+		return (await this._internal.GetXAttr([key]))[key];
 	}
 	/**
 	* 删除文件的扩展属性
 	*/
-	async delXAttr(name) {
-		return this._internal.DelXAttr(name);
+	async delXAttrs(keys) {
+		return this._internal.DelXAttr(keys);
+	}
+	async delXAttr(key) {
+		return (await this._internal.DelXAttr([key]))[0].ok;
 	}
 	/**
-	* 列出文件所有的扩展属性名称
+	* 列出文件所有的扩展属性和内容
 	*/
-	async listXAttr() {
+	async listXAttrs() {
 		return this._internal.ListXAttr();
 	}
 	/**
@@ -503,25 +524,34 @@ var FileSystem = class {
 	* @param targetPath 目标路径
 	* @param attrs 扩展属性键值对记录
 	*/
-	async setXAttr(targetPath, attrs) {
+	async setXAttrs(targetPath, attrs) {
 		return this._internal.SetXAttr(this._normalize(targetPath), attrs);
 	}
+	async setXAttr(targetPath, key, value) {
+		return (await this.setXAttrs(targetPath, { [key]: value }))[0].ok;
+	}
 	/**
 	* 获取扩展属性
 	* @param targetPath 目标路径
 	* @param keys 需要获取的属性名数组
 	*/
-	async getXAttr(targetPath, keys) {
+	async getXAttrs(targetPath, keys) {
 		return this._internal.GetXAttr(this._normalize(targetPath), keys);
 	}
+	async getXAttr(targetPath, key) {
+		return (await this.getXAttrs(targetPath, [key]))[key];
+	}
 	/**
 	* 删除指定的扩展属性
 	* @param targetPath 目标路径
 	* @param keys 需要删除的属性名数组
 	*/
-	async delXAttr(targetPath, keys) {
+	async delXAttrs(targetPath, keys) {
 		return this._internal.DelXAttr(this._normalize(targetPath), keys);
 	}
+	async delXAttr(targetPath, key) {
+		return (await this.delXAttrs(targetPath, [key]))[0].ok;
+	}
 	/**
 	* 列出目标文件或目录的所有扩展属性
 	*/
@@ -530,6 +560,47 @@ var FileSystem = class {
 	}
 };
 //#endregion
+//#region lib/copy.ts
+var CopyProcess = class {
+	nativeCp;
+	constructor() {
+		this.nativeCp = new nativeAddon.CopyProcess();
+	}
+	/**
+	* Add a job to the copy process synchronously
+	*/
+	addJob(config) {
+		this.nativeCp.AddJob(config);
+	}
+	/**
+	* Asynchronously prepare the jobs (resolve DNS, check endpoints, etc.)
+	*/
+	async prepare() {
+		return this.nativeCp.Prepare();
+	}
+	/**
+	* Run the copy process.
+	* @param onProgress Optional progress callback
+	* @returns Array of results corresponding to the jobs added
+	*/
+	async run(onProgress) {
+		if (onProgress) this.nativeCp.SetEventListener("progress", onProgress);
+		return this.nativeCp.Run();
+	}
+	/**
+	* Abort the running copy process.
+	*/
+	abort() {
+		this.nativeCp.CancelJob();
+	}
+	/**
+	* Abort the running copy process. (alias for abort)
+	*/
+	cancelJob() {
+		this.nativeCp.CancelJob();
+	}
+};
+//#endregion
 //#region lib/url.ts
 /**
 * 纯 TypeScript 实现的 XRootD URL 解析器
@@ -631,11 +702,87 @@ var XRootDUrl = class XRootDUrl {
 };
 //#endregion
 //#region lib/env.ts
-const Env = {
-	putInt: nativeAddon.Env.PutInt,
-	putString: nativeAddon.Env.PutString,
-	getInt: nativeAddon.Env.GetInt,
-	getString: nativeAddon.Env.GetString
+function checkIntRange(key, value) {
+	const num = Number(value);
+	if (num < -2147483648 || num > 2147483647) console.warn(`[xrootd] Warning: value ${value} for key "${key}" is out of 32-bit signed integer range [-2147483648, 2147483647]. It will be truncated.`);
+}
+var XRootDEnvironment = class {
+	constructor() {}
+	/**
+	* 设置整数配置项，返回是否设置成功。
+	*/
+	putInt(key, intVal) {
+		checkIntRange(key, intVal);
+		const success = nativeAddon.Env.PutInt(key, Number(intVal));
+		if (!success) console.warn(`[xrootd] Warning: Failed to set integer configuration "${key}"=${intVal}. It might have been overridden by a system environment variable.`);
+		return success;
+	}
+	/**
+	* 设置字符串配置项，返回是否设置成功。
+	*/
+	putString(key, strVal) {
+		if (key === "SecProtocol") {
+			process.env.XrdSecPROTOCOL = strVal;
+			process.env.XRD_SECPROTOCOL = strVal;
+			return true;
+		}
+		const success = nativeAddon.Env.PutString(key, strVal);
+		if (!success) console.warn(`[xrootd] Warning: Failed to set string configuration "${key}"="${strVal}". It might have been overridden by a system environment variable.`);
+		return success;
+	}
+	/**
+	* 设置布尔配置项，返回是否设置成功。
+	*/
+	putBoolean(key, boolVal) {
+		if (typeof boolVal === "boolean") boolVal = boolVal ? "true" : "false";
+		return this.putString(key, boolVal);
+	}
+	/**
+	* 获取整数配置项。
+	*/
+	getInt(key) {
+		return nativeAddon.Env.GetInt(key) ?? void 0;
+	}
+	/**
+	* 获取字符串配置项。
+	*/
+	getString(key) {
+		if (key === "SecProtocol") return process.env.XrdSecPROTOCOL ?? process.env.XRD_SECPROTOCOL ?? void 0;
+		return nativeAddon.Env.GetString(key) ?? void 0;
+	}
+	/**
+	* 批量安全地设置 XRootD 底层参数
+	*/
+	configure(config) {
+		for (const [key, value] of Object.entries(config)) {
+			if (value === void 0 || value === null) continue;
+			let success = true;
+			if (key === "SecProtocol") {
+				process.env.XrdSecPROTOCOL = String(value);
+				process.env.XRD_SECPROTOCOL = String(value);
+				continue;
+			}
+			if (typeof value === "number" || typeof value === "bigint") {
+				checkIntRange(key, value);
+				success = nativeAddon.Env.PutInt(key, Number(value));
+			} else if (typeof value === "string") success = nativeAddon.Env.PutString(key, value);
+			else if (typeof value === "boolean") success = nativeAddon.Env.PutString(key, value ? "true" : "false");
+			else {
+				console.warn(`[xrootd] Unhandled type ${typeof value} for key ${key}.`);
+				success = nativeAddon.Env.PutString(key, value.toString());
+			}
+			if (!success) console.warn(`[xrootd] Warning: Failed to set configuration "${key}"=${value}. It might have been overridden by a system environment variable.`);
+		}
+	}
+	get(key) {
+		if (key === "SecProtocol") return process.env.XrdSecPROTOCOL ?? process.env.XRD_SECPROTOCOL ?? void 0;
+		return nativeAddon.Env.GetInt(key) ?? nativeAddon.Env.GetString(key) ?? void 0;
+	}
 };
+const Env = new XRootDEnvironment();
+Env.configure({
+	RequestTimeout: 30,
+	WorkerThreads: 4
+});
 //#endregion
-export { AccessMode, Env, File, FileSystem, MkDirFlags, OpenFlags, XRootDUrl as URL };
+export { AccessMode, CopyProcess, Env, File, FileSystem, MkDirFlags, OpenFlags, XRootDUrl as URL };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xrootd",
-  "version": "0.1.11",
+  "version": "0.2.0",
   "description": "Prebuilt Node.js Native Addon for XRootD, allowing JS access to EOS file systems",
   "type": "module",
   "exports": {
@@ -70,7 +70,6 @@
   ],
   "gypfile": false,
   "scripts": {
-    "install": "echo 'Skip implicit node-gyp rebuild. Handled by explicit build.'",
     "build:tsc": "tsc --noEmit",
     "build:ts": "tsdown",
     "build:addon": "node-gyp rebuild",
@@ -78,7 +77,7 @@
     "build": "pnpm run build:addon && pnpm run build:binaries && pnpm run build:tsc && pnpm run build:ts",
     "build:clean": "rm -r ./build && pnpm run build",
     "pack": "mkdir -p packages && pnpm pack --pack-destination ./packages",
-    "test:prep": "unrun ./test/prepare.ts",
-    "test": "node --test test/*.mjs"
+    "test:prep": "unrun ./tests/prepare.ts",
+    "test": "node --test tests/*.mjs"
   }
 }