@ecmaos/kernel 0.8.0 → 0.8.1

package/dist/initfs/usr/share/docs/@zenfs/core/index.md

@@ -0,0 +1,192 @@
+# ZenFS
+
+ZenFS is a cross-platform library that emulates the [Node.js filesystem API](http://nodejs.org/api/fs.html).
+It works using a system of backends, which are used by ZenFS to store and retrieve data.
+ZenFS can also integrate with other tools.
+
+## Backends
+
+ZenFS is modular and easily extended. The core includes some built-in backends:
+
+- `InMemory`: Stores files in-memory. This is cleared when the runtime ends (e.g. a user navigating away from a web page or a Node process exiting)
+- `CopyOnWrite`: Use readable and writable file systems with [copy-on-write](https://en.wikipedia.org/wiki/Copy-on-write).
+- `Fetch`: Downloads files over HTTP with the `fetch` API
+- `Port`: Interacts with a remote over a `MessagePort`-like interface (e.g. a worker)
+- `Passthrough`: Use an existing `node:fs` interface with ZenFS
+- `SingleBuffer`: A backend contained within a single buffer. Can be used for synchronous multi-threaded operations using `SharedArrayBuffer`
+
+ZenFS supports a number of other backends.
+Many are provided as separate packages under `@zenfs`.
+More backends can be defined by separate libraries by extending the `FileSystem` class and providing a `Backend` object.
+
+You can find all of the packages available over on [NPM](https://www.npmjs.com/org/zenfs). Below is a list of the backends included with some of them:
+
+- @zenfs/archives: `Zip`, `Iso`
+- @zenfs/cloud: `Dropbox`, `GoogleDrive`, `S3Bucket`
+- @zenfs/dom: `WebAccess` (Web [File System Access API](https://developer.mozilla.org/en-US/docs/Web/API/File_System_API)/OPFS), `IndexedDB`, `WebStorage` (`localStorage`/`sessionStorage`), `XML` (DOM elements)
+- @zenfs/emscripten: `Emscripten` and a plugin for Emscripten's file system API
+
+As an added bonus, all ZenFS backends support synchronous operations.
+Additionally, all of the backends included with the core are cross-platform.
+
+For more information, see the [docs](https://zenfs.dev/core).
+
+## Installing
+
+```sh
+npm install @zenfs/core
+```
+
+If you're using ZenFS, especially for big projects, please consider supporting the project.
+Thousands of hours have been dedicated to its development.
+Your financial support would go a long way toward improving ZenFS and its community.
+
+## Usage
+
+```js
+import { fs } from '@zenfs/core'; // You can also use the default export
+
+fs.writeFileSync('/test.txt', 'You can do this anywhere, including browsers!');
+
+const contents = fs.readFileSync('/test.txt', 'utf-8');
+console.log(contents);
+```
+
+#### Using different and/or multiple backends
+
+A single `InMemory` backend is created by default, mounted on `/`.
+
+You can configure ZenFS to use a different backend and mount multiple backends. It is strongly recommended to do so using the `configure` function.
+
+You can use multiple backends by passing an object to `configure` which maps paths to file systems.
+
+The following example mounts a zip file to `/zip`, in-memory storage to `/tmp`, and IndexedDB to `/home`. Note that `/` has the default in-memory backend.
+
+```js
+import { configure, InMemory } from '@zenfs/core';
+import { IndexedDB } from '@zenfs/dom';
+import { Zip } from '@zenfs/archives';
+
+const res = await fetch('mydata.zip');
+
+await configure({
+	mounts: {
+		'/mnt/zip': { backend: Zip, data: await res.arrayBuffer() },
+		'/tmp': InMemory,
+		'/home': IndexedDB,
+	},
+});
+```
+
+Note that while you aren't required to use absolute paths for the keys of `mounts`, it is a good practice to do so.
+
+> [!TIP]
+> When configuring a mount point, you can pass in
+>
+> 1. A `Backend` object, if the backend has no required options
+> 2. An object that has the options accepted by the backend and a `backend` property which is a `Backend` object
+> 3. A `FileSystem` instance
+
+Here is an example that mounts the `WebStorage` backend from `@zenfs/dom` on `/`:
+
+```js
+import { configureSingle, fs } from '@zenfs/core';
+import { WebStorage } from '@zenfs/dom';
+
+await configureSingle({ backend: WebStorage });
+
+if (!fs.existsSync('/test.txt')) {
+	fs.writeFileSync('/test.txt', 'This will persist across reloads!');
+}
+
+const contents = fs.readFileSync('/test.txt', 'utf-8');
+console.log(contents);
+```
+
+#### FS Promises
+
+The FS promises API is exposed as `promises`.
+
+```js
+import { configureSingle } from '@zenfs/core';
+import { exists, writeFile } from '@zenfs/core/promises';
+import { IndexedDB } from '@zenfs/dom';
+
+await configureSingle({ backend: IndexedDB });
+
+const exists = await exists('/myfile.txt');
+if (!exists) {
+	await writeFile('/myfile.txt', 'Lots of persistent data');
+}
+```
+
+> [!NOTE]
+> You can import the promises API using:
+>
+> 1. Exports from `@zenfs/core/promises`
+> 2. The `promises` export from `@zenfs/core`
+> 3. `fs.promises` on the exported `fs` from `@zenfs/core`.
+
+#### Mounting and unmounting, creating backends
+
+If you would like to create backends without configure (e.g. to do something dynamic at runtime), you may do so by importing the backend and calling `resolveMountConfig` with it.
+
+You can then mount and unmount the backend instance by using `mount` and `umount`.
+
+```js
+import { configure, resolveMountConfig, InMemory } from '@zenfs/core';
+import { IndexedDB } from '@zenfs/dom';
+import { Zip } from '@zenfs/archives';
+
+await configure({
+	mounts: {
+		'/tmp': InMemory,
+		'/home': IndexedDB,
+	},
+});
+
+fs.mkdirSync('/mnt/zip', { recursive: true });
+
+const res = await fetch('mydata.zip');
+const zipfs = await resolveMountConfig({ backend: Zip, data: await res.arrayBuffer() });
+fs.mount('/mnt/zip', zipfs);
+
+// do stuff with the mounted zip
+
+fs.umount('/mnt/zip'); // finished using the zip
+```
+
+> [!CAUTION]
+> Instances of backends follow the _internal_ API. You should never use a backend's methods unless you are extending a backend.
+
+### Devices and device files
+
+ZenFS includes support for device files. These are designed to follow Linux's device file behavior, for consistency and ease of use. Check out the [Devices and Device Drivers](https://zenfs.dev/core/documents/Devices_and_Device_Drivers) documentation for more information.
+
+## `node:*` emulation
+
+ZenFS also includes emulation of some other `node:` modules for various reasons, importable from `@zenfs/core/<name>`:
+
+- `node:path`
+- `node:readline`
+
+For example:
+
+```ts
+import * as path from '@zenfs/core/path';
+```
+
+## Bundling
+
+ZenFS exports a drop-in for Node's `fs` module, so you can use it for your bundler of preference using the default export.
+
+> [!IMPORTANT]
+> See [COPYING.md](./COPYING.md)
+
+## Sponsors
+
+A huge thank you to [deco.cx](https://github.com/deco-cx) for sponsoring ZenFS and helping to make this possible.
+
+## Contact and Support
+
+You can reach out [on Discord](https://zenfs.dev/discord) or by emailing jp@zenfs.dev

package/dist/{install-q2Renhgi.js → install-DPcyci9f.js}

@@ -1,6 +1,6 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-import { c as chalk, s as semver, p as path } from "./kernel-BR5am0OX.js";
+import { c as chalk, s as semver, p as path } from "./kernel-BRRljz7g.js";
 const install = /* @__PURE__ */ __name(async ({ kernel, shell, terminal, args }) => {
   const [packageArg, registryArg, reinstallArg] = args;
   if (!packageArg) {
@@ -118,4 +118,4 @@ const install = /* @__PURE__ */ __name(async ({ kernel, shell, terminal, args })
 export {
   install as default
 };
-//# sourceMappingURL=install-q2Renhgi.js.map
+//# sourceMappingURL=install-DPcyci9f.js.map

package/dist/{install-q2Renhgi.js.map → install-DPcyci9f.js.map}

@@ -1 +1 @@
-{"version":3,"file":"install-q2Renhgi.js","sources":["../src/tree/lib/commands/install.ts"],"sourcesContent":["import chalk from 'chalk'\nimport path from 'path'\nimport semver from 'semver'\n\nimport { CommandArgs } from './'\n\nconst install = async ({ kernel, shell, terminal, args }: CommandArgs) => {\n  const [packageArg, registryArg, reinstallArg] = args as [string, string, boolean]\n  if (!packageArg) {\n    terminal.writeln(chalk.red('Usage: install <package-name>[@version]'))\n    return 1\n  }\n\n  const spec = packageArg.match(/(@[^/]+\\/[^@]+|[^@]+)(?:@([^/]+))?/)\n  if (!spec) {\n    terminal.writeln(chalk.red('Invalid package name format'))\n    return 1\n  }\n\n  const registry = registryArg || shell.env.get('REGISTRY') || 'https://registry.npmjs.org'\n  const packageName = spec[1]?.replace('vnpm:', '')\n  let version = spec[2] || 'latest'\n\n  if (!packageName) {\n    terminal.writeln(chalk.red('Invalid package name format'))\n    return 1\n  }\n\n  const url = `${registry}/${packageName}`\n  const packageInfo = await globalThis.fetch(url)\n  const data = await packageInfo.json()\n\n  if (!data.versions || !data['dist-tags']) {\n    terminal.writeln(chalk.red(`No versions found for ${packageName}`))\n    return 1\n  }\n\n  if (version === 'latest') version = data['dist-tags'].latest\n  else version = semver.maxSatisfying(Object.keys(data.versions), version) || version\n\n  if (reinstallArg) {\n    try {\n      const pkgData = JSON.parse(await kernel.filesystem.fs.readFile(path.join('/usr/lib', packageName, version, 'package.json'), 'utf-8'))\n      for (const bin in pkgData.bin) await kernel.filesystem.fs.unlink(path.join('/usr/bin', bin))\n      await kernel.filesystem.fs.rm(path.join('/usr/lib', packageName, version), { recursive: true, force: true })\n    } catch {}\n  }\n\n  const packagePath = path.join('/usr/lib', packageName, version, 'package.json')\n  if (await kernel.filesystem.fs.exists(packagePath)) {\n    terminal.writeln(chalk.green(`${packageName} v${version} is already installed`))\n    return 0\n  }\n\n  terminal.writeln(`Installing ${data.name} v${version} from ${registry}...`)\n\n  const tarballUrl = data.versions[version]?.dist?.tarball\n  const tarballChecksum = data.versions[version]?.dist?.shasum?.toLowerCase()\n  if (!tarballUrl || !tarballChecksum) {\n    terminal.writeln(chalk.red(`No tarball URL or checksum found for ${packageName} v${version}`))\n    return 1\n  }\n\n  const tarball = await globalThis.fetch(tarballUrl)\n  const arrayBuffer = await tarball.arrayBuffer()\n  const hashBuffer = await crypto.subtle.digest('SHA-1', arrayBuffer)\n  const hashArray = Array.from(new Uint8Array(hashBuffer))\n  const downloadChecksum = hashArray.map(b => b.toString(16).padStart(2, '0')).join('')\n\n  if (downloadChecksum !== tarballChecksum) {\n    terminal.writeln(chalk.red(`Checksum verification failed. Expected ${tarballChecksum} but got ${downloadChecksum}`))\n    return 1\n  }\n\n  const tarballFilename = `${data.name.replace('@', '').replace('/', '-')}-${version}.tar.gz`\n  await kernel.filesystem.fs.writeFile(`/tmp/${tarballFilename}`, new Uint8Array(arrayBuffer))\n\n  // TODO: Support user packages installed to user's home?\n  const extractPath = `/usr/lib/${data.name}/${version}`\n\n  await kernel.filesystem.fs.mkdir(extractPath, { mode: 0o755, recursive: true })\n  await kernel.filesystem.extractTarball(`/tmp/${tarballFilename}`, extractPath)\n  await kernel.filesystem.fs.unlink(`/tmp/${tarballFilename}`)\n  terminal.writeln(chalk.green(`Installed ${data.name} v${version} to ${extractPath}`))\n\n  const packageData = await kernel.filesystem.fs.readFile(packagePath, 'utf-8')\n  const packageJson = JSON.parse(packageData)\n\n  try { // execute preinstall script\n    if (packageJson.scripts?.['ecmaos:preinstall']) await shell.execute(packageJson.scripts['ecmaos:preinstall'])\n  } catch (error) {\n    terminal.writeln(chalk.red(`Failed to execute preinstall script for ${packageName}@${version}: ${error}`))\n    return 1\n  }\n\n  try { // link any bins\n    if (packageJson.bin) {\n      if (typeof packageJson.bin === 'string') {\n        const binPath = path.join('/usr/lib', packageName, version, packageJson.bin)\n        if (!await kernel.filesystem.fs.exists(binPath)) {\n          terminal.writeln(chalk.red(`${binPath} does not exist`))\n          return 1\n        }\n\n        await kernel.filesystem.fs.symlink(binPath, path.join('/usr/bin', packageJson.name))\n        terminal.writeln(chalk.blue(`Linked ${packageJson.name} to ${path.join('/usr/bin', packageJson.name)}`))\n      } else if (typeof packageJson.bin === 'object') {\n        for (const bin in packageJson.bin) {\n          const binPath = path.join('/usr/lib', packageName, version, packageJson.bin[bin])\n          if (!await kernel.filesystem.fs.exists(binPath)) {\n            terminal.writeln(chalk.red(`${binPath} does not exist`))\n            return 1\n          }\n\n          await kernel.filesystem.fs.symlink(binPath, path.join('/usr/bin', bin))\n          terminal.writeln(chalk.blue(`Linked ${bin} to ${path.join('/usr/bin', bin)}`))\n        }\n      }\n    }\n  } catch (error) {\n    terminal.writeln(chalk.red(`Failed to link bins for ${packageName}@${version}: ${error}`))\n  }\n\n  try { // install dependencies\n    if (packageJson.dependencies) {\n      for (const dependency in packageJson.dependencies) {\n        const packageSpec = `${dependency}${packageJson.dependencies[dependency] ? `@${packageJson.dependencies[dependency]}` : ''}`\n        await install({ kernel, shell, terminal, args: [packageSpec, registryArg] })\n      }\n    }\n  } catch (error) {\n    terminal.writeln(chalk.red(`Failed to install dependencies for ${packageName}@${version}: ${error}`))\n    return 1\n  }\n\n  try { // execute postinstall script\n    if (packageJson.scripts?.['ecmaos:postinstall']) await shell.execute(packageJson.scripts['ecmaos:postinstall'])\n  } catch (error) {\n    terminal.writeln(chalk.red(`Failed to execute postinstall script for ${packageName}@${version}: ${error}`))\n    return 1\n  }\n}\n\nexport default install\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"install-DPcyci9f.js","sources":["../src/tree/lib/commands/install.ts"],"sourcesContent":["import chalk from 'chalk'\nimport path from 'path'\nimport semver from 'semver'\n\nimport { CommandArgs } from './'\n\nconst install = async ({ kernel, shell, terminal, args }: CommandArgs) => {\n  const [packageArg, registryArg, reinstallArg] = args as [string, string, boolean]\n  if (!packageArg) {\n    terminal.writeln(chalk.red('Usage: install <package-name>[@version]'))\n    return 1\n  }\n\n  const spec = packageArg.match(/(@[^/]+\\/[^@]+|[^@]+)(?:@([^/]+))?/)\n  if (!spec) {\n    terminal.writeln(chalk.red('Invalid package name format'))\n    return 1\n  }\n\n  const registry = registryArg || shell.env.get('REGISTRY') || 'https://registry.npmjs.org'\n  const packageName = spec[1]?.replace('vnpm:', '')\n  let version = spec[2] || 'latest'\n\n  if (!packageName) {\n    terminal.writeln(chalk.red('Invalid package name format'))\n    return 1\n  }\n\n  const url = `${registry}/${packageName}`\n  const packageInfo = await globalThis.fetch(url)\n  const data = await packageInfo.json()\n\n  if (!data.versions || !data['dist-tags']) {\n    terminal.writeln(chalk.red(`No versions found for ${packageName}`))\n    return 1\n  }\n\n  if (version === 'latest') version = data['dist-tags'].latest\n  else version = semver.maxSatisfying(Object.keys(data.versions), version) || version\n\n  if (reinstallArg) {\n    try {\n      const pkgData = JSON.parse(await kernel.filesystem.fs.readFile(path.join('/usr/lib', packageName, version, 'package.json'), 'utf-8'))\n      for (const bin in pkgData.bin) await kernel.filesystem.fs.unlink(path.join('/usr/bin', bin))\n      await kernel.filesystem.fs.rm(path.join('/usr/lib', packageName, version), { recursive: true, force: true })\n    } catch {}\n  }\n\n  const packagePath = path.join('/usr/lib', packageName, version, 'package.json')\n  if (await kernel.filesystem.fs.exists(packagePath)) {\n    terminal.writeln(chalk.green(`${packageName} v${version} is already installed`))\n    return 0\n  }\n\n  terminal.writeln(`Installing ${data.name} v${version} from ${registry}...`)\n\n  const tarballUrl = data.versions[version]?.dist?.tarball\n  const tarballChecksum = data.versions[version]?.dist?.shasum?.toLowerCase()\n  if (!tarballUrl || !tarballChecksum) {\n    terminal.writeln(chalk.red(`No tarball URL or checksum found for ${packageName} v${version}`))\n    return 1\n  }\n\n  const tarball = await globalThis.fetch(tarballUrl)\n  const arrayBuffer = await tarball.arrayBuffer()\n  const hashBuffer = await crypto.subtle.digest('SHA-1', arrayBuffer)\n  const hashArray = Array.from(new Uint8Array(hashBuffer))\n  const downloadChecksum = hashArray.map(b => b.toString(16).padStart(2, '0')).join('')\n\n  if (downloadChecksum !== tarballChecksum) {\n    terminal.writeln(chalk.red(`Checksum verification failed. Expected ${tarballChecksum} but got ${downloadChecksum}`))\n    return 1\n  }\n\n  const tarballFilename = `${data.name.replace('@', '').replace('/', '-')}-${version}.tar.gz`\n  await kernel.filesystem.fs.writeFile(`/tmp/${tarballFilename}`, new Uint8Array(arrayBuffer))\n\n  // TODO: Support user packages installed to user's home?\n  const extractPath = `/usr/lib/${data.name}/${version}`\n\n  await kernel.filesystem.fs.mkdir(extractPath, { mode: 0o755, recursive: true })\n  await kernel.filesystem.extractTarball(`/tmp/${tarballFilename}`, extractPath)\n  await kernel.filesystem.fs.unlink(`/tmp/${tarballFilename}`)\n  terminal.writeln(chalk.green(`Installed ${data.name} v${version} to ${extractPath}`))\n\n  const packageData = await kernel.filesystem.fs.readFile(packagePath, 'utf-8')\n  const packageJson = JSON.parse(packageData)\n\n  try { // execute preinstall script\n    if (packageJson.scripts?.['ecmaos:preinstall']) await shell.execute(packageJson.scripts['ecmaos:preinstall'])\n  } catch (error) {\n    terminal.writeln(chalk.red(`Failed to execute preinstall script for ${packageName}@${version}: ${error}`))\n    return 1\n  }\n\n  try { // link any bins\n    if (packageJson.bin) {\n      if (typeof packageJson.bin === 'string') {\n        const binPath = path.join('/usr/lib', packageName, version, packageJson.bin)\n        if (!await kernel.filesystem.fs.exists(binPath)) {\n          terminal.writeln(chalk.red(`${binPath} does not exist`))\n          return 1\n        }\n\n        await kernel.filesystem.fs.symlink(binPath, path.join('/usr/bin', packageJson.name))\n        terminal.writeln(chalk.blue(`Linked ${packageJson.name} to ${path.join('/usr/bin', packageJson.name)}`))\n      } else if (typeof packageJson.bin === 'object') {\n        for (const bin in packageJson.bin) {\n          const binPath = path.join('/usr/lib', packageName, version, packageJson.bin[bin])\n          if (!await kernel.filesystem.fs.exists(binPath)) {\n            terminal.writeln(chalk.red(`${binPath} does not exist`))\n            return 1\n          }\n\n          await kernel.filesystem.fs.symlink(binPath, path.join('/usr/bin', bin))\n          terminal.writeln(chalk.blue(`Linked ${bin} to ${path.join('/usr/bin', bin)}`))\n        }\n      }\n    }\n  } catch (error) {\n    terminal.writeln(chalk.red(`Failed to link bins for ${packageName}@${version}: ${error}`))\n  }\n\n  try { // install dependencies\n    if (packageJson.dependencies) {\n      for (const dependency in packageJson.dependencies) {\n        const packageSpec = `${dependency}${packageJson.dependencies[dependency] ? `@${packageJson.dependencies[dependency]}` : ''}`\n        await install({ kernel, shell, terminal, args: [packageSpec, registryArg] })\n      }\n    }\n  } catch (error) {\n    terminal.writeln(chalk.red(`Failed to install dependencies for ${packageName}@${version}: ${error}`))\n    return 1\n  }\n\n  try { // execute postinstall script\n    if (packageJson.scripts?.['ecmaos:postinstall']) await shell.execute(packageJson.scripts['ecmaos:postinstall'])\n  } catch (error) {\n    terminal.writeln(chalk.red(`Failed to execute postinstall script for ${packageName}@${version}: ${error}`))\n    return 1\n  }\n}\n\nexport default install\n"],"names":[],"mappings":"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"}