fileuni 0.0.1 → 0.0.2-alpha2

package/LICENSE

@@ -1,21 +1,43 @@
-MIT License
-
-Copyright (c) 2026 FileUni Team
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+FileUni Source License v1.0
+
+Copyright (c) FileUni Authors
+All rights reserved.
+
+1. Grant of Access
+
+Permission is granted to access, read, and review the source code in this repository for:
+- personal learning,
+- technical review,
+- security research and audit.
+
+2. Restrictions
+
+Without prior written permission from FileUni Authors, you may NOT:
+- use this source code for any commercial purpose,
+- use this source code to build, distribute, or operate products or services that compete with FileUni,
+- sublicense, sell, lease, or otherwise commercially exploit this source code,
+- remove or alter copyright, attribution, or license notices.
+
+3. No Trademark Rights
+
+This license does not grant any right to use the names, logos, trademarks, or branding of FileUni.
+
+4. Contributions
+
+By submitting contributions (including pull requests, patches, or suggestions), you grant FileUni Authors a perpetual, worldwide, non-exclusive, royalty-free license to use, modify, and distribute your contributions as part of FileUni.
+
+5. Disclaimer of Warranty
+
+THE SOURCE CODE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+6. Limitation of Liability
+
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM OR IN CONNECTION WITH THE SOURCE CODE OR THE USE OR OTHER DEALINGS IN THE SOURCE CODE.
+
+7. Termination
+
+Any violation of this license automatically terminates the rights granted under this license.
+
+8. Contact
+
+For commercial licensing, special permissions, or partnership requests, please open an issue in this repository.

package/README.md

@@ -1,13 +1,42 @@
 # fileuni
 
-FileUni - A modern file management solution.
+FileUni CLI distributed through npm as a single package.
+The package downloads the matching prebuilt binary from GitHub Releases during `postinstall`.
 
-## Installation
+## Install
 
 ```bash
 npm install fileuni
 ```
 
+## Run
+
+```bash
+npx fileuni --help
+```
+
+## Platform Override
+
+The installer auto-detects the current platform.
+You can override the target manually when you need a specific Linux runtime variant.
+
+Examples:
+
+```bash
+FILEUNI_NPM_LIBC=musl npm install fileuni
+FILEUNI_NPM_TARGET=x86_64-unknown-linux-musl npm install fileuni
+```
+
+## Optional Controls
+
+```bash
+FILEUNI_NPM_SKIP_DOWNLOAD=1 npm install fileuni
+FILEUNI_NPM_BASE_URL=https://github.com/FileUni/FileUni-Project npm install fileuni
+```
+
 ## License
 
-MIT
+This project is licensed under the FileUni Community Source License v1.0.
+
+For the full license text, please see:
+https://github.com/FileUni/FileUni-Project/blob/main/LICENSE

package/bin/fileuni.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+
+const { spawn } = require('node:child_process');
+const { ensureInstalled } = require('../scripts/fileuni-common.cjs');
+
+(async () => {
+  const binaryPath = await ensureInstalled();
+  const child = spawn(binaryPath, process.argv.slice(2), { stdio: 'inherit' });
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+    process.exit(code ?? 0);
+  });
+})();

package/package.json

@@ -1,39 +1,32 @@
 {
   "name": "fileuni",
-  "version": "0.0.1",
-  "description": "FileUni - A modern file management solution",
-  "keywords": [
-    "file",
-    "management",
-    "storage"
-  ],
-  "license": "MIT",
-  "author": "FileUni Team",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/fileuni/fileuni-workspace.git",
-    "directory": "packages_for_fileuni/npm"
-  },
-  "bugs": {
-    "url": "https://github.com/fileuni/fileuni-workspace/issues"
-  },
+  "version": "0.0.2-alpha2",
+  "description": "FileUni CLI distributed through npm with on-demand platform binary downloads.",
+  "license": "UNLICENSED",
+  "repository": "https://github.com/FileUni/FileUni-Project",
   "homepage": "https://fileuni.com",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
+  "bugs": {
+    "url": "https://github.com/fileuni/FileUni-WorkSpace/issues"
   },
   "files": [
-    "dist",
+    "bin",
+    "scripts",
     "README.md",
     "LICENSE"
   ],
+  "bin": {
+    "fileuni": "bin/fileuni.js"
+  },
+  "scripts": {
+    "postinstall": "node ./scripts/postinstall.cjs"
+  },
+  "dependencies": {
+    "adm-zip": "^0.5.16"
+  },
   "engines": {
     "node": ">=18.0.0"
   },
-  "scripts": {}
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/scripts/fileuni-common.cjs

@@ -0,0 +1,179 @@
+const fs = require('node:fs');
+const fsp = require('node:fs/promises');
+const os = require('node:os');
+const path = require('node:path');
+const AdmZip = require('adm-zip');
+
+const manifest = require('./fileuni-manifest.json');
+const packageRoot = path.resolve(__dirname, '..');
+const binDir = path.join(packageRoot, 'bin');
+const binaryBasePath = path.join(binDir, 'fileuni-bin');
+const metadataPath = path.join(binDir, 'fileuni-target.json');
+
+function normalizeLibc(input) {
+  if (!input) {
+    return null;
+  }
+
+  const value = String(input).trim().toLowerCase();
+  if (value === 'gnu' || value === 'glibc') {
+    return 'gnu';
+  }
+  if (value === 'musl') {
+    return 'musl';
+  }
+  return null;
+}
+
+function detectLibc() {
+  const envLibc = normalizeLibc(process.env.FILEUNI_NPM_LIBC || process.env.npm_config_fileuni_libc);
+  if (envLibc) {
+    return envLibc;
+  }
+
+  if (process.platform !== 'linux') {
+    return null;
+  }
+
+  const report = process.report;
+  if (report && typeof report.getReport === 'function') {
+    const glibcVersion = report.getReport()?.header?.glibcVersionRuntime;
+    if (glibcVersion) {
+      return 'gnu';
+    }
+  }
+
+  return 'musl';
+}
+
+function supportedTargets() {
+  return manifest.targets.map((entry) => entry.target).sort();
+}
+
+function selectTarget() {
+  const explicitTarget = process.env.FILEUNI_NPM_TARGET || process.env.npm_config_fileuni_target;
+  if (explicitTarget) {
+    const match = manifest.targets.find((entry) => entry.target === explicitTarget);
+    if (!match) {
+      throw new Error(`Unsupported FILEUNI_NPM_TARGET: ${explicitTarget}. Supported targets: ${supportedTargets().join(', ')}`);
+    }
+    return match;
+  }
+
+  const libc = detectLibc();
+  const candidates = manifest.targets.filter((entry) => entry.os === process.platform && entry.arch === process.arch);
+  if (candidates.length === 0) {
+    throw new Error(`Unsupported platform: ${process.platform}/${process.arch}. Supported targets: ${supportedTargets().join(', ')}`);
+  }
+
+  if (process.platform !== 'linux') {
+    return candidates[0];
+  }
+
+  const preferredLibc = libc || 'gnu';
+  const exact = candidates.find((entry) => entry.libc === preferredLibc);
+  if (exact) {
+    return exact;
+  }
+
+  const fallbackGnu = candidates.find((entry) => entry.libc === 'gnu');
+  if (fallbackGnu) {
+    return fallbackGnu;
+  }
+
+  return candidates[0];
+}
+
+function binaryPathFor(entry) {
+  return entry.binary_name.endsWith('.exe') ? `${binaryBasePath}.exe` : binaryBasePath;
+}
+
+async function readInstalledMetadata() {
+  try {
+    const raw = await fsp.readFile(metadataPath, 'utf-8');
+    return JSON.parse(raw);
+  } catch (error) {
+    if (error && error.code === 'ENOENT') {
+      return null;
+    }
+    throw error;
+  }
+}
+
+async function writeInstalledMetadata(entry) {
+  await fsp.writeFile(
+    metadataPath,
+    `${JSON.stringify({ target: entry.target, asset_name: entry.asset_name, release_tag: manifest.release_tag }, null, 2)}\n`,
+    'utf-8',
+  );
+}
+
+function releaseBaseUrl() {
+  const customBaseUrl = process.env.FILEUNI_NPM_BASE_URL;
+  if (customBaseUrl) {
+    return customBaseUrl.replace(/\/$/, '');
+  }
+  return `https://github.com/${manifest.repository}`;
+}
+
+function releaseAssetUrl(entry) {
+  return `${releaseBaseUrl()}/releases/download/${manifest.release_tag}/${entry.asset_name}`;
+}
+
+async function downloadAsset(entry, zipPath) {
+  const response = await fetch(releaseAssetUrl(entry));
+  if (!response.ok) {
+    throw new Error(`Failed to download ${entry.asset_name}: HTTP ${response.status} ${response.statusText}`);
+  }
+
+  const buffer = Buffer.from(await response.arrayBuffer());
+  await fsp.writeFile(zipPath, buffer);
+}
+
+async function installTarget(entry) {
+  await fsp.mkdir(binDir, { recursive: true });
+  const tmpDir = await fsp.mkdtemp(path.join(os.tmpdir(), 'fileuni-npm-'));
+  const zipPath = path.join(tmpDir, 'fileuni.zip');
+
+  try {
+    await downloadAsset(entry, zipPath);
+
+    const extractDir = path.join(tmpDir, 'extract');
+    await fsp.mkdir(extractDir, { recursive: true });
+    const archive = new AdmZip(zipPath);
+    archive.extractAllTo(extractDir, true);
+
+    const targetBinary = binaryPathFor(entry);
+    const extractedBinary = path.join(extractDir, entry.binary_name);
+    if (!fs.existsSync(extractedBinary)) {
+      throw new Error(`Downloaded archive does not contain ${entry.binary_name}`);
+    }
+
+    await fsp.copyFile(extractedBinary, targetBinary);
+    if (!entry.binary_name.endsWith('.exe')) {
+      await fsp.chmod(targetBinary, 0o755);
+    }
+    await writeInstalledMetadata(entry);
+    return targetBinary;
+  } finally {
+    await fsp.rm(tmpDir, { recursive: true, force: true });
+  }
+}
+
+async function ensureInstalled() {
+  const entry = selectTarget();
+  const targetBinary = binaryPathFor(entry);
+  const metadata = await readInstalledMetadata();
+
+  if (metadata && metadata.target === entry.target && fs.existsSync(targetBinary)) {
+    return targetBinary;
+  }
+
+  return installTarget(entry);
+}
+
+module.exports = {
+  ensureInstalled,
+  selectTarget,
+  supportedTargets,
+};

package/scripts/fileuni-manifest.json

@@ -0,0 +1,143 @@
+{
+  "repository": "FileUni/FileUni-Project",
+  "release_tag": "manually_20260310_145953",
+  "version": "0.0.2-alpha2",
+  "targets": [
+    {
+      "target": "x86_64-unknown-linux-gnu",
+      "os": "linux",
+      "arch": "x64",
+      "libc": "gnu",
+      "binary_name": "fileuni",
+      "asset_name": "FileUni-cli-x86_64-linux-gnu.zip"
+    },
+    {
+      "target": "x86_64-unknown-linux-musl",
+      "os": "linux",
+      "arch": "x64",
+      "libc": "musl",
+      "binary_name": "fileuni",
+      "asset_name": "FileUni-cli-x86_64-linux-musl.zip"
+    },
+    {
+      "target": "aarch64-unknown-linux-gnu",
+      "os": "linux",
+      "arch": "arm64",
+      "libc": "gnu",
+      "binary_name": "fileuni",
+      "asset_name": "FileUni-cli-aarch64-linux-gnu.zip"
+    },
+    {
+      "target": "aarch64-unknown-linux-musl",
+      "os": "linux",
+      "arch": "arm64",
+      "libc": "musl",
+      "binary_name": "fileuni",
+      "asset_name": "FileUni-cli-aarch64-linux-musl.zip"
+    },
+    {
+      "target": "i686-unknown-linux-gnu",
+      "os": "linux",
+      "arch": "ia32",
+      "libc": "gnu",
+      "binary_name": "fileuni",
+      "asset_name": "FileUni-cli-x86_32-linux-gnu.zip"
+    },
+    {
+      "target": "i686-unknown-linux-musl",
+      "os": "linux",
+      "arch": "ia32",
+      "libc": "musl",
+      "binary_name": "fileuni",
+      "asset_name": "FileUni-cli-x86_32-linux-musl.zip"
+    },
+    {
+      "target": "arm-unknown-linux-gnueabi",
+      "os": "linux",
+      "arch": "arm",
+      "libc": "gnu",
+      "binary_name": "fileuni",
+      "asset_name": "FileUni-cli-arm-linux-gnu.zip"
+    },
+    {
+      "target": "armv7-unknown-linux-musleabihf",
+      "os": "linux",
+      "arch": "arm",
+      "libc": "musl",
+      "binary_name": "fileuni",
+      "asset_name": "FileUni-cli-armv7-linux-musl.zip"
+    },
+    {
+      "target": "riscv64gc-unknown-linux-gnu",
+      "os": "linux",
+      "arch": "riscv64",
+      "libc": "gnu",
+      "binary_name": "fileuni",
+      "asset_name": "FileUni-cli-riscv64gc-linux-gnu.zip"
+    },
+    {
+      "target": "powerpc64le-unknown-linux-gnu",
+      "os": "linux",
+      "arch": "ppc64",
+      "libc": "gnu",
+      "binary_name": "fileuni",
+      "asset_name": "FileUni-cli-powerpc64le-linux-gnu.zip"
+    },
+    {
+      "target": "x86_64-pc-windows-msvc",
+      "os": "win32",
+      "arch": "x64",
+      "binary_name": "fileuni.exe",
+      "asset_name": "FileUni-cli-x86_64-windows-msvc.exe.zip"
+    },
+    {
+      "target": "i686-pc-windows-msvc",
+      "os": "win32",
+      "arch": "ia32",
+      "binary_name": "fileuni.exe",
+      "asset_name": "FileUni-cli-x86_32-windows-msvc.exe.zip"
+    },
+    {
+      "target": "x86_64-apple-darwin",
+      "os": "darwin",
+      "arch": "x64",
+      "binary_name": "fileuni",
+      "asset_name": "FileUni-cli-x86_64-macos-darwin.zip"
+    },
+    {
+      "target": "aarch64-apple-darwin",
+      "os": "darwin",
+      "arch": "arm64",
+      "binary_name": "fileuni",
+      "asset_name": "FileUni-cli-aarch64-macos-darwin.zip"
+    },
+    {
+      "target": "aarch64-linux-android",
+      "os": "android",
+      "arch": "arm64",
+      "binary_name": "fileuni",
+      "asset_name": "FileUni-cli-aarch64-android-cli.zip"
+    },
+    {
+      "target": "armv7-linux-androideabi",
+      "os": "android",
+      "arch": "arm",
+      "binary_name": "fileuni",
+      "asset_name": "FileUni-cli-armv7-android-cli.zip"
+    },
+    {
+      "target": "x86_64-linux-android",
+      "os": "android",
+      "arch": "x64",
+      "binary_name": "fileuni",
+      "asset_name": "FileUni-cli-x86_64-android-cli.zip"
+    },
+    {
+      "target": "x86_64-unknown-freebsd",
+      "os": "freebsd",
+      "arch": "x64",
+      "binary_name": "fileuni",
+      "asset_name": "FileUni-cli-x86_64-freebsd-freebsd.zip"
+    }
+  ]
+}

package/scripts/postinstall.cjs

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+
+const { ensureInstalled } = require('./fileuni-common.cjs');
+
+(async () => {
+  if (process.env.FILEUNI_NPM_SKIP_DOWNLOAD === '1') {
+    console.log('[fileuni] Skipping binary download because FILEUNI_NPM_SKIP_DOWNLOAD=1');
+    return;
+  }
+
+  const binaryPath = await ensureInstalled();
+  console.log(`[fileuni] Installed binary: ${binaryPath}`);
+})().catch((error) => {
+  console.error(`[fileuni] ${error instanceof Error ? error.message : String(error)}`);
+  process.exit(1);
+});