echogarden 1.8.6 → 2.0.0

package/src/utilities/FileSystem.ts

@@ -2,166 +2,249 @@ import * as fsExtra from 'fs-extra/esm'
 import gracefulFS from 'graceful-fs'
 import * as os from 'node:os'
 
-import path from 'node:path'
 import { promisify } from 'node:util'
-import { OpenPromise } from './OpenPromise.js'
-import { getRandomHexString } from './Utilities.js'
+import { getRandomHexString, parseJson, stringifyAndFormatJson } from './Utilities.js'
 import { appName } from '../api/Common.js'
-import { getAppTempDir } from './PathUtilities.js'
+import { getAppTempDir, getDirName, joinPath, normalizePath, parsePath } from './PathUtilities.js'
+
+import { createDynamicUint8Array } from '../data-structures/DynamicTypedArray.js'
+import { ChunkedUtf8Decoder } from '../encodings/Utf8.js'
+import { FileWriter } from './FileWriter.js'
+import { FileReader } from './FileReader.js'
 
-export const readFile = promisify(gracefulFS.readFile)
-//export const writeFile = promisify(gracefulFS.writeFile)
-export const readdir = promisify(gracefulFS.readdir)
-export const stat = promisify(gracefulFS.stat)
 export const open = promisify(gracefulFS.open)
 export const close = promisify(gracefulFS.close)
+
+export const read = promisify(gracefulFS.read)
+export const write = promisify(gracefulFS.write)
+
+export const existsSync = gracefulFS.existsSync
+
+export const stat = promisify(gracefulFS.stat)
 export const chmod = promisify(gracefulFS.chmod)
-export const copyFile = promisify(gracefulFS.copyFile)
 export const access = promisify(gracefulFS.access)
 
-export const createReadStream = gracefulFS.createReadStream
-export const createWriteStream = gracefulFS.createWriteStream
-export const existsSync = gracefulFS.existsSync
+export const readdir = promisify(gracefulFS.readdir)
+export const copyFile = promisify(gracefulFS.copyFile)
 
 export const remove = fsExtra.remove
 export const copy = fsExtra.copy
-export const outputFile = fsExtra.outputFile
 
-export async function readDirRecursive(dir: string, fileFilter?: (filePath: string) => boolean) {
-	if (!(await stat(dir)).isDirectory()) {
-		throw new Error(`'${dir}' is not a directory`)
-	}
+///////////////////////////////////////////////////////////////////////////////////////////
+// File read operations
+///////////////////////////////////////////////////////////////////////////////////////////
+export async function readFileAsBinary(filePath: string) {
+	const chunkSize = 2 ** 20
 
-	const filenamesInDir = await readdir(dir)
-	const filesInDir = filenamesInDir.map(filename => path.join(dir, filename))
+	const fileInfo = await stat(filePath)
+	const fileSize = fileInfo.size
 
-	const result: string[] = []
-	const subDirectories: string[] = []
+	const fileReader = new FileReader(filePath)
+	const buffer = new Uint8Array(chunkSize)
+	const result = createDynamicUint8Array(fileSize)
 
-	for (const filePath of filesInDir) {
-		if ((await stat(filePath)).isDirectory()) {
-			subDirectories.push(filePath)
-		} else {
-			if (fileFilter && !fileFilter(filePath)) {
-				continue
-			}
+	while (!fileReader.isFinished) {
+		const chunk = await fileReader.readChunk(buffer)
 
-			result.push(filePath)
-		}
+		result.addArray(chunk)
 	}
 
-	for (const subDirectory of subDirectories) {
-		const filesInSubdirectory = await readDirRecursive(subDirectory, fileFilter)
-		result.push(...filesInSubdirectory)
+	return result.toTypedArray()
+}
+
+export async function readFileAsUtf8(filePath: string) {
+	const chunkSize = 2 ** 20
+
+	const fileReader = new FileReader(filePath)
+	const buffer = new Uint8Array(chunkSize)
+
+	const result = new ChunkedUtf8Decoder()
+
+	while (!fileReader.isFinished) {
+		const chunk = await fileReader.readChunk(buffer)
+
+		result.writeChunk(chunk)
 	}
 
-	return result
+	return result.toString()
 }
 
-export async function isFileIsUpToDate(filePath: string, timeRangeSeconds: number) {
-	const fileUpdateTime = (await stat(filePath)).mtime.valueOf()
+export async function readAndParseJsonFile(jsonFilePath: string, useJson5 = false) {
+	const textContent = await readFileAsUtf8(jsonFilePath)
 
-	const currentTime = (new Date()).valueOf()
+	return parseJson(textContent, useJson5)
+}
 
-	const differenceInMilliseconds = currentTime - fileUpdateTime
+///////////////////////////////////////////////////////////////////////////////////////////
+// File write operations
+///////////////////////////////////////////////////////////////////////////////////////////
+export async function writeFile(filePath: string, content: Uint8Array | string) {
+	if (content instanceof Uint8Array) {
+		return writeBinaryFile(filePath, content)
+	} else if (typeof content === 'string') {
+		return writeUtf8File(filePath, content)
+	} else {
+		throw new Error(`Content can only be a Uint8Array or string`)
+	}
+}
 
-	const differenceInSeconds = differenceInMilliseconds / 1000
+export async function writeBinaryFile(filePath: string, content: Uint8Array) {
+	const maxChunkSize = 2 ** 20
 
-	return differenceInSeconds <= timeRangeSeconds
-}
+	const fileDir = getDirName(filePath)
 
-export async function computeFileSha256Hex(filePath: string) {
-	const resultOpenPromise = new OpenPromise<string>()
+	await ensureDir(fileDir)
 
-	const crypto = await import('crypto')
-	const hash = crypto.createHash('sha256')
+	const fileWriter = new FileWriter(filePath)
 
-	const readStream = createReadStream(filePath)
+	let readOffset = 0
 
-	readStream.on('data', data => hash.update(data))
-	readStream.on('error', error => resultOpenPromise.reject(error))
-	readStream.on('end', () => resultOpenPromise.resolve(hash.digest('hex')))
+	while (true) {
+		const chunk = content.subarray(readOffset, readOffset + maxChunkSize)
 
-	return resultOpenPromise.promise
+		if (chunk.length === 0) {
+			break
+		}
+
+		await fileWriter.write(chunk)
+
+		readOffset += chunk.length
+	}
+
+	await fileWriter.dispose()
 }
 
-export async function readAndParseJsonFile(jsonFilePath: string, useJson5 = false) {
-	const fileContent = await readFile(jsonFilePath, { encoding: 'utf-8' })
+export async function writeUtf8File(filePath: string, content: string) {
+	const maxChunkSize = 2 ** 20
 
-	if (useJson5) {
-		const { default: JSON5 } = await import('json5')
+	const fileDir = getDirName(filePath)
 
-		return JSON5.parse(fileContent)
-	} else {
-		return JSON.parse(fileContent)
+	await ensureDir(fileDir)
+
+	const fileWriter = new FileWriter(filePath)
+
+	const textEncoder = new TextEncoder()
+
+	let readOffset = 0
+
+	while (true) {
+		const stringChunk = content.substring(readOffset, readOffset + maxChunkSize)
+
+		if (stringChunk.length === 0) {
+			break
+		}
+
+		const chunk = textEncoder.encode(stringChunk)
+
+		await fileWriter.write(chunk)
+
+		readOffset += stringChunk.length
 	}
+
+	await fileWriter.dispose()
 }
 
-export async function writeFile(filePath: string, data: string | NodeJS.ArrayBufferView, options?: fsExtra.WriteFileOptions) {
-	return outputFile(filePath, data, options)
+export async function writeJsonFile(filePath: string, content: any, useJson5 = false) {
+	const textContent = await stringifyAndFormatJson(content, useJson5)
+
+	await writeUtf8File(filePath, textContent)
 }
 
-export async function writeFileSafe(filePath: string, data: string | NodeJS.ArrayBufferView, options?: fsExtra.WriteFileOptions) {
+export async function writeFileSafe(filePath: string, content: Uint8Array | string) {
 	const tempDir = getAppTempDir(appName)
-	const tempFilePath = path.join(tempDir, `${getRandomHexString(16)}.partial`)
+	const tempFilePath = joinPath(tempDir, `${getRandomHexString(16)}.partial`)
 
-	await writeFile(tempFilePath, data, options)
+	await writeFile(tempFilePath, content)
 
 	await move(tempFilePath, filePath)
 }
 
-export function getAppDataDir(appName: string) {
-	let dataDir: string
+///////////////////////////////////////////////////////////////////////////////////////////
+// Directory operations
+///////////////////////////////////////////////////////////////////////////////////////////
+export async function ensureDir(dirPath: string) {
+	dirPath = normalizePath(dirPath)
 
-	const platform = process.platform
-	const homeDir = os.homedir()
+	if (existsSync(dirPath)) {
+		const dirStats = await stat(dirPath)
 
-	if (platform == 'win32') {
-		dataDir = path.join(homeDir, 'AppData', 'Local', appName)
-	} else if (platform == 'darwin') {
-		dataDir = path.join(homeDir, 'Library', 'Application Support', appName)
-	} else if (platform == 'linux') {
-		dataDir = path.join(homeDir, '.local', 'share', appName)
+		if (!dirStats.isDirectory()) {
+			throw new Error(`The path '${dirPath}' exists but is not a directory.`)
+		}
 	} else {
-		throw new Error(`Unsupport platform ${platform}`)
+		return fsExtra.ensureDir(dirPath)
 	}
+}
 
-	return dataDir
+export async function testDirectoryIsWritable(dir: string) {
+	const testFileName = joinPath(dir, getRandomHexString(16))
+
+	try {
+		await fsExtra.createFile(testFileName)
+		await remove(testFileName)
+	} catch (e) {
+		return false
+	}
+
+	return true
 }
 
-export async function chmodRecursive(rootPath: string, newMode: number) {
-	const rootPathStat = await stat(rootPath)
+export async function readDirRecursive(dir: string, pathFilter?: (filePath: string) => boolean) {
+	if (!(await stat(dir)).isDirectory()) {
+		throw new Error(`'${dir}' is not a directory`)
+	}
 
-	await chmod(rootPath, newMode)
+	const filenamesInDir = await readdir(dir)
+	const filesInDir = filenamesInDir.map(filename => joinPath(dir, filename))
 
-	if (rootPathStat.isDirectory()) {
-		const fileList = await readdir(rootPath)
+	const result: string[] = []
+	const subDirectories: string[] = []
 
-		for (const filename of fileList) {
-			const filePath = path.join(rootPath, filename)
+	for (const filePath of filesInDir) {
+		if ((await stat(filePath)).isDirectory()) {
+			subDirectories.push(filePath)
+		} else {
+			if (pathFilter && !pathFilter(filePath)) {
+				continue
+			}
 
-			await chmodRecursive(filePath, newMode)
+			result.push(filePath)
 		}
 	}
+
+	for (const subDirectory of subDirectories) {
+		const filesInSubdirectory = await readDirRecursive(subDirectory, pathFilter)
+		result.push(...filesInSubdirectory)
+	}
+
+	return result
 }
 
-export async function ensureDir(dirPath: string) {
-	dirPath = path.normalize(dirPath)
+export function getAppDataDir(appName: string) {
+	let dataDir: string
 
-	if (existsSync(dirPath)) {
-		const dirStats = await stat(dirPath)
+	const platform = process.platform
+	const homeDir = os.homedir()
 
-		if (!dirStats.isDirectory()) {
-			throw new Error(`The path '${dirPath}' exists but is not a directory.`)
-		}
+	if (platform == 'win32') {
+		dataDir = joinPath(homeDir, 'AppData', 'Local', appName)
+	} else if (platform == 'darwin') {
+		dataDir = joinPath(homeDir, 'Library', 'Application Support', appName)
+	} else if (platform == 'linux') {
+		dataDir = joinPath(homeDir, '.local', 'share', appName)
 	} else {
-		return fsExtra.ensureDir(dirPath)
+		throw new Error(`Unsupport platform ${platform}`)
 	}
+
+	return dataDir
 }
 
+///////////////////////////////////////////////////////////////////////////////////////////
+// Copy operations
+///////////////////////////////////////////////////////////////////////////////////////////
 export async function move(source: string, dest: string) {
-	source = path.normalize(source)
-	dest = path.normalize(dest)
+	source = normalizePath(source)
+	dest = normalizePath(dest)
 
 	if (existsSync(dest)) {
 		const destPathExistsAndIsWritable = await existsAndIsWritable(dest)
@@ -170,7 +253,7 @@ export async function move(source: string, dest: string) {
 			throw new Error(`The destination path '${dest}' exists but is not writable. There may be a permissions or locking issue.`)
 		}
 	} else {
-		const destDir = path.parse(dest).dir
+		const destDir = parsePath(dest).dir
 		const destDirIsWritable = await testDirectoryIsWritable(destDir)
 
 		if (!destDirIsWritable) {
@@ -181,6 +264,9 @@ export async function move(source: string, dest: string) {
 	return fsExtra.move(source, dest, { overwrite: true })
 }
 
+///////////////////////////////////////////////////////////////////////////////////////////
+// Misc operations
+///////////////////////////////////////////////////////////////////////////////////////////
 export async function existsAndIsWritable(targetPath: string) {
 	try {
 		await access(targetPath, gracefulFS.constants.W_OK);
@@ -191,36 +277,49 @@ export async function existsAndIsWritable(targetPath: string) {
 	return true
 }
 
-export async function testDirectoryIsWritable(dir: string) {
-	const testFileName = path.join(dir, getRandomHexString(16))
+export async function chmodRecursive(rootPath: string, newMode: number) {
+	const rootPathStat = await stat(rootPath)
 
-	try {
-		await fsExtra.createFile(testFileName)
-		await remove(testFileName)
-	} catch (e) {
-		return false
+	await chmod(rootPath, newMode)
+
+	if (rootPathStat.isDirectory()) {
+		const fileList = await readdir(rootPath)
+
+		for (const filename of fileList) {
+			const filePath = joinPath(rootPath, filename)
+
+			await chmodRecursive(filePath, newMode)
+		}
 	}
+}
 
-	return true
+export async function isFileIsUpToDate(filePath: string, maxTimeDifferenceSeconds: number) {
+	const fileUpdateTime = (await stat(filePath)).mtime.valueOf()
+
+	const currentTime = (new Date()).valueOf()
+
+	const differenceInMilliseconds = currentTime - fileUpdateTime
+
+	const differenceInSeconds = differenceInMilliseconds / 1000
+
+	return differenceInSeconds <= maxTimeDifferenceSeconds
 }
 
-export async function copyFileAlternative(source: string, dest: string) {
-	return new Promise<void>((resolve, reject) => {
-		const readStream = createReadStream(source)
-		const writeStream = createWriteStream(dest)
+export async function computeFileSha256Hex(filePath: string) {
+	const crypto = await import('crypto')
+
+	const hash = crypto.createHash('sha256')
 
-		readStream.on('error', (err: any) => {
-			reject(err)
-		})
+	const fileReader = new FileReader(filePath)
+	const buffer = new Uint8Array(2 ** 16)
 
-		writeStream.on('error', (err: any) => {
-			reject(err)
-		})
+	while (!fileReader.isFinished) {
+		const chunk = await fileReader.readChunk(buffer)
 
-		readStream.pipe(writeStream)
+		hash.update(chunk)
+	}
 
-		readStream.on('end', () => {
-			resolve()
-		})
-	})
+	const result = hash.digest('hex')
+
+	return result
 }

package/src/utilities/FileWriter.ts

@@ -0,0 +1,72 @@
+import { write, open, close } from "./FileSystem.js"
+
+export class FileWriter {
+	private fileHandle?: number
+	private disposed = false
+	private writeOffset = 0
+
+	constructor(public readonly filePath: string) {
+	}
+
+	async write(chunk: Uint8Array) {
+		if (this.isDisposed) {
+			throw new Error(`FileWriter has been disposed`)
+		}
+
+		await this.openIfNeeded()
+
+		let chunkReadOffset = 0
+
+		while (chunkReadOffset < chunk.length) {
+			let bytesWritten: number
+
+			try {
+				({ bytesWritten } = await write(this.fileHandle!, chunk, chunkReadOffset, undefined, this.writeOffset))
+			} catch (e) {
+				await this.dispose()
+
+				throw e
+			}
+
+			chunkReadOffset += bytesWritten
+			this.writeOffset += bytesWritten
+		}
+	}
+
+	private async openIfNeeded() {
+		if (this.isDisposed) {
+			throw new Error(`FileWriter has been disposed`)
+		}
+
+		if (this.isOpened) {
+			return
+		}
+
+		this.fileHandle = await open(this.filePath, 'w')
+	}
+
+	async dispose() {
+		if (this.isDisposed) {
+			return
+		}
+
+		if (this.isOpened) {
+			try {
+				await close(this.fileHandle!)
+			} catch (e) {
+			}
+		}
+
+		this.disposed = true
+		this.writeOffset = 0
+		this.fileHandle = undefined
+	}
+
+	get isOpened() {
+		return this.fileHandle !== undefined
+	}
+
+	get isDisposed() {
+		return this.disposed
+	}
+}

package/src/utilities/NpmUtilities.ts

@@ -0,0 +1,23 @@
+import { request } from 'gaxios'
+
+export async function getPackageLatestVersion(packageName: string, timeout = 10000) {
+	const response = await request<any>({
+		method: 'GET',
+
+		url: `https://registry.npmjs.org/${packageName}/latest`,
+
+		params: {
+		},
+
+		headers: {
+		},
+
+		responseType: 'json',
+
+		timeout,
+	})
+
+	const result = response.data
+
+	return result.version
+}

package/src/utilities/PackageManager.ts

@@ -1,9 +1,8 @@
-import path from 'node:path'
 import { downloadAndExtractTarball } from './FileDownloader.js'
 import { getAppDataDir, ensureDir, existsSync, remove } from './FileSystem.js'
 import { appName } from '../api/Common.js'
 import { GaxiosOptions } from 'gaxios'
-import { getAppTempDir } from './PathUtilities.js'
+import { getAppTempDir, joinPath } from './PathUtilities.js'
 import { getGlobalOption } from '../api/GlobalOptions.js'
 
 export async function loadPackage(packageName: string) {
@@ -11,7 +10,7 @@ export async function loadPackage(packageName: string) {
 
 	const packagesPath = await ensureAndGetPackagesDir()
 
-	const packagePath = path.join(packagesPath, packageName)
+	const packagePath = joinPath(packagesPath, packageName)
 
 	if (existsSync(packagePath)) {
 		return packagePath
@@ -44,7 +43,7 @@ export async function removePackage(packageName: string) {
 
 	const packagesPath = await ensureAndGetPackagesDir()
 
-	const packagePath = path.join(packagesPath, packageName)
+	const packagePath = joinPath(packagesPath, packageName)
 
 	await remove(packagePath)
 }
@@ -52,7 +51,7 @@ export async function removePackage(packageName: string) {
 export async function ensureAndGetPackagesDir() {
 	const dataPath = getAppDataDir(appName)
 
-	const packagesPath = path.join(dataPath, 'packages')
+	const packagesPath = joinPath(dataPath, 'packages')
 
 	await ensureDir(packagesPath)
 
@@ -209,4 +208,8 @@ const packageVersionTagResolutionLookup: { [packageName: string]: string } = {
 	// W2V-BERT models
 	'w2v-bert-2.0-int8': '20240517',
 	'w2v-bert-2.0-uint8': '20240517',
+
+	// NSNet2 models
+	'nsnet2-20ms-baseline': '20242610',
+	'nsnet2-20ms-48k-baseline': '20242610',
 }

package/src/utilities/PathUtilities.ts

@@ -1,14 +1,15 @@
-import path from 'node:path'
+import * as NodePath from 'node:path'
 import { fileURLToPath } from 'node:url'
 import * as os from 'node:os'
 
 export function getModuleRootDir() {
-	const currentScriptDir = path.dirname(fileURLToPath(import.meta.url))
-	return path.resolve(currentScriptDir, '..', '..')
+	const currentScriptDir = getDirName(fileURLToPath(import.meta.url))
+
+	return resolvePath(currentScriptDir, '..', '..')
 }
 
 export function resolveToModuleRootDir(relativePath: string) {
-	return path.resolve(getModuleRootDir(), relativePath)
+	return resolvePath(getModuleRootDir(), relativePath)
 }
 
 export function getLowercaseFileExtension(filename: string) {
@@ -28,14 +29,42 @@ export function getAppTempDir(appName: string) {
 	const homeDir = os.homedir()
 
 	if (platform == 'win32') {
-		tempDir = path.join(homeDir, 'AppData', 'Local', 'Temp', appName)
+		tempDir = joinPath(homeDir, 'AppData', 'Local', 'Temp', appName)
 	} else if (platform == 'darwin') {
-		tempDir = path.join(homeDir, 'Library', 'Caches', appName)
+		tempDir = joinPath(homeDir, 'Library', 'Caches', appName)
 	} else if (platform == 'linux') {
-		tempDir = path.join(homeDir, '.cache', appName)
+		tempDir = joinPath(homeDir, '.cache', appName)
 	} else {
 		throw new Error(`Unsupport platform ${platform}`)
 	}
 
 	return tempDir
 }
+
+export function joinPath(...paths: string[]) {
+	return NodePath.join(...paths)
+}
+
+export function resolvePath(...paths: string[]) {
+	return NodePath.resolve(...paths)
+}
+
+export function normalizePath(path: string) {
+	return NodePath.normalize(path)
+}
+
+export function getBaseName(path: string) {
+	return NodePath.basename(path)
+}
+
+export function getDirName(path: string) {
+	return NodePath.dirname(path)
+}
+
+export function getFileNameWithoutExtension(filePath: string) {
+	return NodePath.parse(filePath).name
+}
+
+export function parsePath(path: string) {
+	return NodePath.parse(path)
+}