bucketfs 0.0.1 → 0.0.2

package/README.md

@@ -1,16 +1,79 @@
-# tpipe
+# bucketfs
 
-A quick distribution of the Training Pipes CLI.
+Command-line interface for managing Training Pipes resources.
 
 ## Installation
 
 ```bash
-npm install tpipe
+npm install -g bucketfs
 ```
 
-## Usage
+Or run directly with npx:
 
-Coming soon.
+```bash
+npx bucketfs <command>
+```
+
+## Quick Start
+
+```bash
+# Authenticate
+bucketfs login
+
+# List projects
+bucketfs projects list
+
+# Create a project
+bucketfs projects create --name my-project
+
+# Create a storage connection
+bucketfs connections create \
+  --project <project-id> \
+  --provider aws \
+  --uri s3://my-bucket/prefix \
+  --region aws:us-east-1
+
+# Create and start a mount
+bucketfs mounts create \
+  --project <project-id> \
+  --connection <connection-id> \
+  --region us-east-1
+
+bucketfs mounts start <mount-id>
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `bucketfs login` | Store authentication token |
+| `bucketfs logout` | Remove stored token |
+| `bucketfs config show` | Show current configuration |
+| `bucketfs config set-api-url <url>` | Set API base URL |
+| `bucketfs projects list` | List projects |
+| `bucketfs projects create --name <n>` | Create a project |
+| `bucketfs projects get <id>` | Get project details |
+| `bucketfs projects delete <id>` | Delete a project |
+| `bucketfs connections list --project <id>` | List connections |
+| `bucketfs connections create ...` | Create a connection |
+| `bucketfs connections get <id>` | Get connection details |
+| `bucketfs connections delete <id>` | Delete a connection |
+| `bucketfs connections verify <id>` | Verify a connection |
+| `bucketfs mounts list --project <id>` | List mounts |
+| `bucketfs mounts create ...` | Create a mount |
+| `bucketfs mounts get <id>` | Get mount details |
+| `bucketfs mounts start <id>` | Start a mount |
+| `bucketfs mounts stop <id>` | Stop a mount |
+| `bucketfs mounts delete <id>` | Delete a mount |
+| `bucketfs mounts flush <id>` | Trigger a flush |
+
+## Configuration
+
+Config is stored at `~/.bucketfs/config.json`. You can also use:
+
+- `--api-url` flag to override the API base URL per-command
+- `--token` flag to override the auth token per-command
+- `BUCKETFS_TOKEN` environment variable
 
 ## License
 

package/bin/cli.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+
+const PLATFORM_PACKAGES = {
+  "darwin-arm64": "@bucketfs/cli-darwin-arm64",
+  "darwin-x64": "@bucketfs/cli-darwin-x64",
+  "linux-arm64": "@bucketfs/cli-linux-arm64",
+  "linux-x64": "@bucketfs/cli-linux-x64",
+  "win32-x64": "@bucketfs/cli-win32-x64",
+};
+
+function getBinaryName() {
+  return process.platform === "win32" ? "bucketfs.exe" : "bucketfs";
+}
+
+function getBinaryPath() {
+  const platformKey = `${process.platform}-${process.arch}`;
+  const pkgName = PLATFORM_PACKAGES[platformKey];
+  const binaryName = getBinaryName();
+
+  if (!pkgName) {
+    throw new Error(
+      `Unsupported platform: ${platformKey}. ` +
+        `Supported: ${Object.keys(PLATFORM_PACKAGES).join(", ")}`
+    );
+  }
+
+  // Try optionalDependency first
+  try {
+    return require.resolve(`${pkgName}/bin/${binaryName}`);
+  } catch (_) {
+    // Fall through to fallback
+  }
+
+  // Try fallback binary (downloaded by postinstall)
+  const fallback = path.join(__dirname, "..", binaryName);
+  if (fs.existsSync(fallback)) {
+    return fallback;
+  }
+
+  throw new Error(
+    `Could not find the bucketfs binary. The platform package ${pkgName} ` +
+      `was not installed and no fallback binary was found.\n\n` +
+      `Try reinstalling: npm install bucketfs\n` +
+      `Or ensure optionalDependencies are enabled.`
+  );
+}
+
+try {
+  const binary = getBinaryPath();
+  execFileSync(binary, process.argv.slice(2), { stdio: "inherit" });
+} catch (err) {
+  if (err.status !== undefined) {
+    process.exit(err.status);
+  }
+  console.error(err.message);
+  process.exit(1);
+}

package/install.js

@@ -0,0 +1,116 @@
+const fs = require("fs");
+const path = require("path");
+const zlib = require("zlib");
+const https = require("https");
+
+const PLATFORM_PACKAGES = {
+  "darwin-arm64": "@bucketfs/cli-darwin-arm64",
+  "darwin-x64": "@bucketfs/cli-darwin-x64",
+  "linux-arm64": "@bucketfs/cli-linux-arm64",
+  "linux-x64": "@bucketfs/cli-linux-x64",
+  "win32-x64": "@bucketfs/cli-win32-x64",
+};
+
+const VERSION = require("./package.json").version;
+
+const binaryName =
+  process.platform === "win32" ? "bucketfs.exe" : "bucketfs";
+
+const platformKey = `${process.platform}-${process.arch}`;
+const platformPackage = PLATFORM_PACKAGES[platformKey];
+
+if (!platformPackage) {
+  console.error(`bucketfs: unsupported platform ${platformKey}`);
+  process.exit(1);
+}
+
+function isPlatformPackageInstalled() {
+  try {
+    require.resolve(`${platformPackage}/bin/${binaryName}`);
+    return true;
+  } catch (_) {
+    return false;
+  }
+}
+
+function makeRequest(url) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(url, (response) => {
+        if (response.statusCode >= 200 && response.statusCode < 300) {
+          const chunks = [];
+          response.on("data", (chunk) => chunks.push(chunk));
+          response.on("end", () => resolve(Buffer.concat(chunks)));
+        } else if (
+          response.statusCode >= 300 &&
+          response.statusCode < 400 &&
+          response.headers.location
+        ) {
+          makeRequest(response.headers.location).then(resolve, reject);
+        } else {
+          reject(
+            new Error(
+              `npm registry responded with HTTP ${response.statusCode}`
+            )
+          );
+        }
+      })
+      .on("error", reject);
+  });
+}
+
+function extractFileFromTarball(tarballBuffer, filepath) {
+  let offset = 0;
+  while (offset < tarballBuffer.length) {
+    const header = tarballBuffer.subarray(offset, offset + 512);
+    offset += 512;
+
+    const fileName = header.toString("utf-8", 0, 100).replace(/\0.*/g, "");
+    const fileSize = parseInt(
+      header.toString("utf-8", 124, 136).replace(/\0.*/g, ""),
+      8
+    );
+
+    if (isNaN(fileSize)) break;
+
+    if (fileName === filepath) {
+      return tarballBuffer.subarray(offset, offset + fileSize);
+    }
+
+    offset = (offset + fileSize + 511) & ~511;
+  }
+  return null;
+}
+
+async function downloadBinaryFromNpm() {
+  const scopedName = platformPackage.replace("@", "").replace("/", "-");
+  const url = `https://registry.npmjs.org/${platformPackage}/-/${scopedName}-${VERSION}.tgz`;
+
+  console.log(`bucketfs: downloading ${platformPackage}@${VERSION}...`);
+
+  const tarballGz = await makeRequest(url);
+  const tarball = zlib.unzipSync(tarballGz);
+
+  const binary = extractFileFromTarball(tarball, `package/bin/${binaryName}`);
+  if (!binary) {
+    throw new Error(
+      `Could not find bin/${binaryName} in the downloaded package`
+    );
+  }
+
+  const dest = path.join(__dirname, binaryName);
+  fs.writeFileSync(dest, binary, { mode: 0o755 });
+  console.log(`bucketfs: binary installed to ${dest}`);
+}
+
+if (isPlatformPackageInstalled()) {
+  // Already installed via optionalDependencies
+  process.exit(0);
+}
+
+downloadBinaryFromNpm().catch((err) => {
+  console.warn(
+    `bucketfs: failed to download binary (${err.message}). ` +
+      `The CLI may not work until a binary is available.`
+  );
+});

package/package.json

@@ -1,16 +1,37 @@
 {
   "name": "bucketfs",
-  "version": "0.0.1",
-  "description": "A quick distribution of the Training Pipes CLI",
-  "main": "dist/index.js",
+  "version": "0.0.2",
+  "description": "BucketFS CLI - manage Training Pipes resources from the command line",
+  "files": [
+    "bin/",
+    "install.js",
+    "README.md"
+  ],
+  "bin": {
+    "bucketfs": "bin/cli.js"
+  },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "postinstall": "node install.js"
+  },
+  "optionalDependencies": {
+    "@bucketfs/cli-darwin-arm64": "0.0.2",
+    "@bucketfs/cli-darwin-x64": "0.0.2",
+    "@bucketfs/cli-linux-arm64": "0.0.2",
+    "@bucketfs/cli-linux-x64": "0.0.2",
+    "@bucketfs/cli-win32-x64": "0.0.2"
   },
   "keywords": [
-    "Training",
-    "Pipes",
+    "bucketfs",
+    "training-pipes",
+    "cli",
+    "storage",
+    "mount",
     "AI"
   ],
   "author": "Training Pipes",
-  "license": "UNLICENSED"
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pwgardipee/training-pipes"
+  }
 }

package/dist/index.js

@@ -1,9 +0,0 @@
-// Training Pipes CLI - Shell placeholder
-// This is a placeholder file for the npm package distribution
-
-module.exports = {
-  version: "0.0.1",
-  init: function() {
-    console.log("Training Pipes CLI - Coming soon");
-  }
-};