stow-cli 2.0.4 → 2.2.0

package/dist/search-TRTPX2SQ.js

@@ -0,0 +1,135 @@
+import {
+  isJsonOutput,
+  output
+} from "./chunk-P2BKGBQE.js";
+import {
+  formatBytes,
+  formatTable
+} from "./chunk-FZGOTXTE.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/search.ts
+async function textSearch(query, options) {
+  const stow = createStow();
+  const parsedLimit = options.limit ? Number.parseInt(options.limit, 10) : null;
+  const data = await stow.search.text({
+    query,
+    ...options.bucket ? { bucket: options.bucket } : {},
+    ...parsedLimit && parsedLimit > 0 ? { limit: parsedLimit } : {}
+  });
+  if (data.results.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(data);
+    } else {
+      console.log("No results found.");
+    }
+    return;
+  }
+  output(
+    data,
+    () => {
+      const rows = data.results.map((r) => [
+        r.key,
+        formatBytes(r.size),
+        r.similarity.toFixed(3)
+      ]);
+      return formatTable(["Key", "Size", "Similarity"], rows);
+    },
+    { json: options.json }
+  );
+}
+async function similarSearch(options) {
+  const stow = createStow();
+  const parsedLimit = options.limit ? Number.parseInt(options.limit, 10) : null;
+  const data = await stow.search.similar({
+    fileKey: options.file,
+    ...options.bucket ? { bucket: options.bucket } : {},
+    ...parsedLimit && parsedLimit > 0 ? { limit: parsedLimit } : {}
+  });
+  if (data.results.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(data);
+    } else {
+      console.log("No similar files found.");
+    }
+    return;
+  }
+  output(
+    data,
+    () => {
+      const rows = data.results.map((r) => [
+        r.key,
+        formatBytes(r.size),
+        r.similarity.toFixed(3)
+      ]);
+      return formatTable(["Key", "Size", "Similarity"], rows);
+    },
+    { json: options.json }
+  );
+}
+async function colorSearch(options) {
+  const stow = createStow();
+  const parsedLimit = options.limit ? Number.parseInt(options.limit, 10) : null;
+  const data = await stow.search.color({
+    hex: options.hex,
+    ...options.bucket ? { bucket: options.bucket } : {},
+    ...parsedLimit && parsedLimit > 0 ? { limit: parsedLimit } : {}
+  });
+  if (data.results.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(data);
+    } else {
+      console.log("No results found.");
+    }
+    return;
+  }
+  output(
+    data,
+    () => {
+      const rows = data.results.map((r) => [
+        r.key,
+        r.contentType,
+        r.colorDistance.toFixed(3)
+      ]);
+      return formatTable(["Key", "Type", "Distance"], rows);
+    },
+    { json: options.json }
+  );
+}
+async function diverseSearch(options) {
+  const stow = createStow();
+  const parsedLimit = options.limit ? Number.parseInt(options.limit, 10) : null;
+  const data = await stow.search.diverse({
+    ...options.bucket ? { bucket: options.bucket } : {},
+    ...parsedLimit && parsedLimit > 0 ? { limit: parsedLimit } : {}
+  });
+  if (data.results.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(data);
+    } else {
+      console.log("No results found.");
+    }
+    return;
+  }
+  output(
+    data,
+    () => {
+      const rows = data.results.map((r) => [
+        r.key,
+        formatBytes(r.size),
+        r.similarity.toFixed(3)
+      ]);
+      return formatTable(["Key", "Size", "Similarity"], rows);
+    },
+    { json: options.json }
+  );
+}
+export {
+  colorSearch,
+  diverseSearch,
+  similarSearch,
+  textSearch
+};

package/dist/tags-MCFL5M2J.js

@@ -0,0 +1,82 @@
+import {
+  validateInput
+} from "./chunk-OHAFRKN5.js";
+import {
+  formatTable,
+  outputJson
+} from "./chunk-ELSDWMEB.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/tags.ts
+async function listTags(options) {
+  const stow = createStow();
+  const data = await stow.tags.list();
+  if (options.json) {
+    outputJson(data);
+    return;
+  }
+  if (data.tags.length === 0) {
+    console.log("No tags yet. Create one with: stow tags create <name>");
+    return;
+  }
+  const rows = data.tags.map((t) => [t.name, t.slug, t.color ?? "\u2014", t.id]);
+  console.log(formatTable(["Name", "Slug", "Color", "ID"], rows));
+}
+async function createTag(name, options) {
+  validateInput(name, "tag name");
+  if (options.dryRun) {
+    console.log(
+      JSON.stringify(
+        {
+          dryRun: true,
+          action: "createTag",
+          details: {
+            name,
+            color: options.color ?? null
+          }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  const stow = createStow();
+  const tag = await stow.tags.create({
+    name,
+    ...options.color ? { color: options.color } : {}
+  });
+  if (options.json) {
+    outputJson(tag);
+    return;
+  }
+  console.log(`Created tag: ${tag.name}`);
+}
+async function deleteTag(id, options = {}) {
+  validateInput(id, "tag id");
+  if (options.dryRun) {
+    console.log(
+      JSON.stringify(
+        {
+          dryRun: true,
+          action: "deleteTag",
+          details: { id }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  const stow = createStow();
+  await stow.tags.delete(id);
+  console.log(`Deleted tag: ${id}`);
+}
+export {
+  createTag,
+  deleteTag,
+  listTags
+};

package/dist/tags-VH44BGQL.js

@@ -0,0 +1,90 @@
+import {
+  parseJsonInput
+} from "./chunk-3BLL5SQJ.js";
+import {
+  validateInput
+} from "./chunk-PLZFHPLC.js";
+import {
+  isJsonOutput,
+  output
+} from "./chunk-P2BKGBQE.js";
+import {
+  formatTable
+} from "./chunk-FZGOTXTE.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/tags.ts
+async function listTags(options) {
+  const stow = createStow();
+  const data = await stow.tags.list();
+  if (data.tags.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(data);
+    } else {
+      console.log("No tags yet. Create one with: stow tags create <name>");
+    }
+    return;
+  }
+  output(data, () => {
+    const rows = data.tags.map((t) => [t.name, t.slug, t.color ?? "\u2014", t.id]);
+    return formatTable(["Name", "Slug", "Color", "ID"], rows);
+  });
+}
+async function createTag(name, options) {
+  const input = parseJsonInput(
+    options.inputJson,
+    { name, color: options.color }
+  );
+  validateInput(input.name, "tag name");
+  if (options.dryRun) {
+    console.log(
+      JSON.stringify(
+        {
+          dryRun: true,
+          action: "createTag",
+          details: {
+            name: input.name,
+            color: input.color ?? null
+          }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  const stow = createStow();
+  const tag = await stow.tags.create({
+    name: input.name,
+    ...input.color ? { color: input.color } : {}
+  });
+  output(tag, () => `Created tag: ${tag.name}`);
+}
+async function deleteTag(id, options = {}) {
+  validateInput(id, "tag id");
+  if (options.dryRun) {
+    console.log(
+      JSON.stringify(
+        {
+          dryRun: true,
+          action: "deleteTag",
+          details: { id }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  const stow = createStow();
+  await stow.tags.delete(id);
+  console.log(`Deleted tag: ${id}`);
+}
+export {
+  createTag,
+  deleteTag,
+  listTags
+};

package/dist/upload-5TAWJU5N.js

@@ -0,0 +1,126 @@
+import {
+  validateBucketName
+} from "./chunk-OHAFRKN5.js";
+import {
+  formatBytes
+} from "./chunk-ELSDWMEB.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/upload.ts
+import { existsSync, readFileSync, statSync } from "fs";
+import { basename, resolve } from "path";
+var CONTENT_TYPES = {
+  png: "image/png",
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  gif: "image/gif",
+  webp: "image/webp",
+  svg: "image/svg+xml",
+  ico: "image/x-icon",
+  avif: "image/avif",
+  pdf: "application/pdf",
+  mp4: "video/mp4",
+  webm: "video/webm",
+  mov: "video/quicktime",
+  mp3: "audio/mpeg",
+  wav: "audio/wav",
+  ogg: "audio/ogg",
+  zip: "application/zip",
+  tar: "application/x-tar",
+  gz: "application/gzip",
+  txt: "text/plain",
+  json: "application/json",
+  xml: "application/xml",
+  html: "text/html",
+  css: "text/css",
+  js: "application/javascript"
+};
+function getContentType(filename) {
+  const ext = filename.toLowerCase().split(".").pop();
+  return CONTENT_TYPES[ext || ""] || "application/octet-stream";
+}
+function readFile(filePath) {
+  const resolvedPath = resolve(filePath);
+  if (!existsSync(resolvedPath)) {
+    console.error(`Error: File not found: ${filePath}`);
+    process.exit(1);
+  }
+  const buffer = readFileSync(resolvedPath);
+  const filename = basename(resolvedPath);
+  const contentType = getContentType(filename);
+  return { buffer, filename, contentType };
+}
+function printUploadResult(url, options, opts) {
+  if (options.quiet) {
+    console.log(url);
+    return;
+  }
+  console.error(opts?.deduped ? "Done! (deduped)" : "Done!");
+  console.log("");
+  console.log(url);
+}
+async function uploadDrop(filePath, options) {
+  const { buffer, filename, contentType } = readFile(filePath);
+  if (!options.quiet) {
+    console.error(`Uploading ${filename} (${formatBytes(buffer.length)})...`);
+  }
+  const stow = createStow();
+  const result = await stow.drop(buffer, {
+    filename,
+    contentType
+  });
+  printUploadResult(result.url, options);
+}
+async function uploadFile(filePath, options) {
+  if (options.bucket) {
+    validateBucketName(options.bucket);
+  }
+  const resolvedPath = resolve(filePath);
+  if (!existsSync(resolvedPath)) {
+    console.error(`Error: File not found: ${filePath}`);
+    process.exit(1);
+  }
+  const filename = basename(resolvedPath);
+  const contentType = getContentType(filename);
+  const size = statSync(resolvedPath).size;
+  if (options.dryRun) {
+    console.log(
+      JSON.stringify(
+        {
+          dryRun: true,
+          action: "upload",
+          details: {
+            file: resolvedPath,
+            filename,
+            contentType,
+            size,
+            bucket: options.bucket ?? null
+          }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  const buffer = readFileSync(resolvedPath);
+  if (!options.quiet) {
+    console.error(`Uploading ${filename} (${formatBytes(buffer.length)})...`);
+  }
+  const stow = createStow();
+  const result = await stow.uploadFile(buffer, {
+    ...options.bucket ? { bucket: options.bucket } : {},
+    filename,
+    contentType
+  });
+  printUploadResult(result.url ?? result.key, options, {
+    deduped: result.deduped
+  });
+}
+export {
+  uploadDrop,
+  uploadFile
+};

package/dist/upload-OS6Q6LW5.js

@@ -0,0 +1,126 @@
+import {
+  validateBucketName
+} from "./chunk-PLZFHPLC.js";
+import {
+  formatBytes
+} from "./chunk-FZGOTXTE.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/upload.ts
+import { existsSync, readFileSync, statSync } from "fs";
+import { basename, resolve } from "path";
+var CONTENT_TYPES = {
+  png: "image/png",
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  gif: "image/gif",
+  webp: "image/webp",
+  svg: "image/svg+xml",
+  ico: "image/x-icon",
+  avif: "image/avif",
+  pdf: "application/pdf",
+  mp4: "video/mp4",
+  webm: "video/webm",
+  mov: "video/quicktime",
+  mp3: "audio/mpeg",
+  wav: "audio/wav",
+  ogg: "audio/ogg",
+  zip: "application/zip",
+  tar: "application/x-tar",
+  gz: "application/gzip",
+  txt: "text/plain",
+  json: "application/json",
+  xml: "application/xml",
+  html: "text/html",
+  css: "text/css",
+  js: "application/javascript"
+};
+function getContentType(filename) {
+  const ext = filename.toLowerCase().split(".").pop();
+  return CONTENT_TYPES[ext || ""] || "application/octet-stream";
+}
+function readFile(filePath) {
+  const resolvedPath = resolve(filePath);
+  if (!existsSync(resolvedPath)) {
+    console.error(`Error: File not found: ${filePath}`);
+    process.exit(1);
+  }
+  const buffer = readFileSync(resolvedPath);
+  const filename = basename(resolvedPath);
+  const contentType = getContentType(filename);
+  return { buffer, filename, contentType };
+}
+function printUploadResult(url, options, opts) {
+  if (options.quiet) {
+    console.log(url);
+    return;
+  }
+  console.error(opts?.deduped ? "Done! (deduped)" : "Done!");
+  console.log("");
+  console.log(url);
+}
+async function uploadDrop(filePath, options) {
+  const { buffer, filename, contentType } = readFile(filePath);
+  if (!options.quiet) {
+    console.error(`Uploading ${filename} (${formatBytes(buffer.length)})...`);
+  }
+  const stow = createStow();
+  const result = await stow.drop(buffer, {
+    filename,
+    contentType
+  });
+  printUploadResult(result.url, options);
+}
+async function uploadFile(filePath, options) {
+  if (options.bucket) {
+    validateBucketName(options.bucket);
+  }
+  const resolvedPath = resolve(filePath);
+  if (!existsSync(resolvedPath)) {
+    console.error(`Error: File not found: ${filePath}`);
+    process.exit(1);
+  }
+  const filename = basename(resolvedPath);
+  const contentType = getContentType(filename);
+  const size = statSync(resolvedPath).size;
+  if (options.dryRun) {
+    console.log(
+      JSON.stringify(
+        {
+          dryRun: true,
+          action: "upload",
+          details: {
+            file: resolvedPath,
+            filename,
+            contentType,
+            size,
+            bucket: options.bucket ?? null
+          }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  const buffer = readFileSync(resolvedPath);
+  if (!options.quiet) {
+    console.error(`Uploading ${filename} (${formatBytes(buffer.length)})...`);
+  }
+  const stow = createStow();
+  const result = await stow.uploadFile(buffer, {
+    ...options.bucket ? { bucket: options.bucket } : {},
+    filename,
+    contentType
+  });
+  printUploadResult(result.url ?? result.key, options, {
+    deduped: result.deduped
+  });
+}
+export {
+  uploadDrop,
+  uploadFile
+};

package/dist/whoami-TVRKBM74.js

@@ -0,0 +1,28 @@
+import {
+  formatBytes
+} from "./chunk-FZGOTXTE.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/whoami.ts
+async function whoami() {
+  const stow = createStow();
+  const data = await stow.whoami();
+  console.log(`Account: ${data.user.email}`);
+  console.log("");
+  console.log(`Buckets:  ${data.stats.bucketCount}`);
+  console.log(`Files:    ${data.stats.totalFiles}`);
+  console.log(`Storage:  ${formatBytes(data.stats.totalBytes)}`);
+  if (data.key) {
+    console.log("");
+    console.log(`API Key:  ${data.key.name}`);
+    console.log(`Scope:    ${data.key.scope}`);
+    const perms = Object.entries(data.key.permissions).filter(([, v]) => v).map(([k]) => k);
+    console.log(`Perms:    ${perms.join(", ")}`);
+  }
+}
+export {
+  whoami
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stow-cli",
-  "version": "2.0.4",
+  "version": "2.2.0",
   "type": "module",
   "description": "CLI for Stow file storage",
   "license": "MIT",
@@ -22,14 +22,8 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup src/cli.ts --format esm --shims",
-    "dev": "tsup src/cli.ts --format esm --shims --watch",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
   "dependencies": {
-    "@howells/stow-server": "workspace:*",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "clipboardy": "^5.3.1",
     "commander": "^14.0.3",
     "ink": "^6.8.0",
@@ -37,14 +31,22 @@
     "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",
     "open": "^11.0.0",
-    "react": "^19.2.4"
+    "react": "^19.2.4",
+    "zod": "^4.3.6",
+    "@howells/stow-server": "2.2.0"
   },
   "devDependencies": {
-    "@stow/typescript-config": "workspace:*",
     "@types/node": "^25.5.0",
     "@types/react": "19.2.14",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.0"
+    "vitest": "^4.1.0",
+    "@stow/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup src/cli.ts --format esm --shims",
+    "dev": "tsup src/cli.ts --format esm --shims --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}