stow-cli 2.2.1 → 2.2.3

package/dist/delete-3UDS4RMH.js

@@ -0,0 +1,34 @@
+import {
+  validateBucketName,
+  validateFileKey
+} from "./chunk-533UGNLM.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/delete.ts
+async function deleteFile(bucket, key, options = {}) {
+  validateBucketName(bucket);
+  validateFileKey(key);
+  if (options.dryRun) {
+    console.log(
+      JSON.stringify(
+        {
+          dryRun: true,
+          action: "deleteFile",
+          details: { bucket, key }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  const stow = createStow();
+  await stow.deleteFile(key, { bucket });
+  console.log(`Deleted: ${key} from ${bucket}`);
+}
+export {
+  deleteFile
+};

package/dist/delete-CQJEGLP3.js

@@ -0,0 +1,34 @@
+import {
+  validateBucketName,
+  validateFileKey
+} from "./chunk-NBHBVKP5.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/delete.ts
+async function deleteFile(bucket, key, options = {}) {
+  validateBucketName(bucket);
+  validateFileKey(key);
+  if (options.dryRun) {
+    console.log(
+      JSON.stringify(
+        {
+          dryRun: true,
+          action: "deleteFile",
+          details: { bucket, key }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  const stow = createStow();
+  await stow.deleteFile(key, { bucket });
+  console.log(`Deleted: ${key} from ${bucket}`);
+}
+export {
+  deleteFile
+};

package/dist/describe-NH3K3LLW.js

@@ -0,0 +1,79 @@
+import {
+  CLI_DOCS
+} from "./chunk-MYFLRBWC.js";
+import {
+  output
+} from "./chunk-KPIQZBTO.js";
+
+// src/commands/describe.ts
+var COMMAND_MAP = {
+  upload: "upload",
+  drop: "drop",
+  delete: "delete",
+  whoami: "whoami",
+  open: "open",
+  buckets: "buckets",
+  "buckets.create": "bucketsCreate",
+  "buckets.rename": "bucketsRename",
+  "buckets.delete": "bucketsDelete",
+  files: "files",
+  "files.get": "filesGet",
+  "files.update": "filesUpdate",
+  "files.enrich": "filesEnrich",
+  "files.missing": "filesMissing",
+  search: "search",
+  "search.text": "searchText",
+  "search.similar": "searchSimilar",
+  "search.color": "searchColor",
+  "search.diverse": "searchDiverse",
+  tags: "tags",
+  "tags.create": "tagsCreate",
+  "tags.delete": "tagsDelete",
+  drops: "drops",
+  "drops.delete": "dropsDelete",
+  profiles: "profiles",
+  "profiles.create": "profilesCreate",
+  "profiles.get": "profilesGet",
+  "profiles.delete": "profilesDelete",
+  jobs: "jobs",
+  "jobs.retry": "jobsRetry",
+  "jobs.delete": "jobsDelete",
+  admin: "admin",
+  "admin.health": "adminHealth",
+  "admin.backfill": "adminBackfill",
+  "admin.cleanup-drops": "adminCleanupDrops",
+  "admin.purge-events": "adminPurgeEvents",
+  "admin.reconcile-files": "adminReconcileFiles",
+  "admin.retry-sync-failures": "adminRetrySyncFailures",
+  "admin.jobs": "adminJobs",
+  "admin.jobs.retry": "adminJobsRetry",
+  "admin.jobs.delete": "adminJobsDelete",
+  "admin.queues": "adminQueues",
+  "admin.queues.clean": "adminQueuesClean"
+};
+function describeCommand(commandPath) {
+  if (!commandPath) {
+    output({
+      commands: Object.keys(COMMAND_MAP).sort()
+    });
+    return;
+  }
+  const docKey = COMMAND_MAP[commandPath];
+  if (!(docKey && CLI_DOCS[docKey])) {
+    console.error(`Unknown command: ${commandPath}`);
+    console.error(`Available: ${Object.keys(COMMAND_MAP).sort().join(", ")}`);
+    process.exit(1);
+    return;
+  }
+  const doc = CLI_DOCS[docKey];
+  output({
+    command: commandPath,
+    description: doc.description,
+    usage: doc.usage,
+    examples: doc.examples,
+    notes: doc.notes ?? []
+  });
+}
+export {
+  describeCommand
+};

package/dist/describe-W3ED4VW3.js

@@ -0,0 +1,79 @@
+import {
+  CLI_DOCS
+} from "./chunk-XJDK2CBE.js";
+import {
+  output
+} from "./chunk-RH4BOSYB.js";
+
+// src/commands/describe.ts
+var COMMAND_MAP = {
+  upload: "upload",
+  drop: "drop",
+  delete: "delete",
+  whoami: "whoami",
+  open: "open",
+  buckets: "buckets",
+  "buckets.create": "bucketsCreate",
+  "buckets.rename": "bucketsRename",
+  "buckets.delete": "bucketsDelete",
+  files: "files",
+  "files.get": "filesGet",
+  "files.update": "filesUpdate",
+  "files.enrich": "filesEnrich",
+  "files.missing": "filesMissing",
+  search: "search",
+  "search.text": "searchText",
+  "search.similar": "searchSimilar",
+  "search.color": "searchColor",
+  "search.diverse": "searchDiverse",
+  tags: "tags",
+  "tags.create": "tagsCreate",
+  "tags.delete": "tagsDelete",
+  drops: "drops",
+  "drops.delete": "dropsDelete",
+  profiles: "profiles",
+  "profiles.create": "profilesCreate",
+  "profiles.get": "profilesGet",
+  "profiles.delete": "profilesDelete",
+  jobs: "jobs",
+  "jobs.retry": "jobsRetry",
+  "jobs.delete": "jobsDelete",
+  admin: "admin",
+  "admin.health": "adminHealth",
+  "admin.backfill": "adminBackfill",
+  "admin.cleanup-drops": "adminCleanupDrops",
+  "admin.purge-events": "adminPurgeEvents",
+  "admin.reconcile-files": "adminReconcileFiles",
+  "admin.retry-sync-failures": "adminRetrySyncFailures",
+  "admin.jobs": "adminJobs",
+  "admin.jobs.retry": "adminJobsRetry",
+  "admin.jobs.delete": "adminJobsDelete",
+  "admin.queues": "adminQueues",
+  "admin.queues.clean": "adminQueuesClean"
+};
+function describeCommand(commandPath) {
+  if (!commandPath) {
+    output({
+      commands: Object.keys(COMMAND_MAP).sort()
+    });
+    return;
+  }
+  const docKey = COMMAND_MAP[commandPath];
+  if (!(docKey && CLI_DOCS[docKey])) {
+    console.error(`Unknown command: ${commandPath}`);
+    console.error(`Available: ${Object.keys(COMMAND_MAP).sort().join(", ")}`);
+    process.exit(1);
+    return;
+  }
+  const doc = CLI_DOCS[docKey];
+  output({
+    command: commandPath,
+    description: doc.description,
+    usage: doc.usage,
+    examples: doc.examples,
+    notes: doc.notes ?? []
+  });
+}
+export {
+  describeCommand
+};

package/dist/drops-XO4CZ4BH.js

@@ -0,0 +1,39 @@
+import {
+  formatBytes,
+  formatTable,
+  usageBar
+} from "./chunk-PE6V3MVP.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/drops.ts
+async function listDrops() {
+  const stow = createStow();
+  const data = await stow.listDrops();
+  if (data.drops.length === 0) {
+    console.log("No drops yet. Create one with: stow drop <file>");
+    return;
+  }
+  const rows = data.drops.map((d) => [
+    d.filename,
+    formatBytes(Number(d.size)),
+    d.contentType,
+    d.url
+  ]);
+  console.log(formatTable(["Filename", "Size", "Type", "URL"], rows));
+  console.log(
+    `
+Storage: ${usageBar(data.usage.bytes, data.usage.limit)}  ${formatBytes(data.usage.bytes)} / ${formatBytes(data.usage.limit)}`
+  );
+}
+async function deleteDrop(id) {
+  const stow = createStow();
+  await stow.deleteDrop(id);
+  console.log(`Deleted drop: ${id}`);
+}
+export {
+  deleteDrop,
+  listDrops
+};

package/dist/files-BIMA5L2G.js

@@ -0,0 +1,206 @@
+import {
+  parseJsonInput
+} from "./chunk-AHBVZRDR.js";
+import {
+  validateBucketName,
+  validateFileKey
+} from "./chunk-533UGNLM.js";
+import {
+  isJsonOutput,
+  output
+} from "./chunk-RH4BOSYB.js";
+import {
+  formatBytes,
+  formatTable
+} from "./chunk-FZGOTXTE.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import {
+  getApiKey,
+  getBaseUrl
+} from "./chunk-TOADDO2F.js";
+
+// src/commands/files.ts
+async function listFiles(bucket, options) {
+  const stow = createStow();
+  const parsedLimit = options.limit ? Number.parseInt(options.limit, 10) : null;
+  const data = await stow.listFiles({
+    bucket,
+    ...options.search ? { prefix: options.search } : {},
+    ...parsedLimit && Number.isFinite(parsedLimit) && parsedLimit > 0 ? { limit: parsedLimit } : {}
+  });
+  if (data.files.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(data);
+    } else {
+      console.log(`No files in bucket '${bucket}'.`);
+    }
+    return;
+  }
+  if (options.json || isJsonOutput()) {
+    output(data);
+    return;
+  }
+  const rows = data.files.map((f) => [
+    f.key,
+    formatBytes(f.size),
+    f.lastModified.split("T")[0] ?? f.lastModified
+  ]);
+  console.log(formatTable(["Key", "Size", "Modified"], rows));
+  if (data.nextCursor) {
+    console.log("\n(more files available \u2014 use --limit to see more)");
+  }
+}
+async function getFile(bucket, key, _options) {
+  const stow = createStow();
+  const file = await stow.getFile(key, { bucket });
+  output(file, () => {
+    const lines = [
+      formatTable(
+        ["Field", "Value"],
+        [
+          ["Key", file.key],
+          ["Size", formatBytes(file.size)],
+          ["Type", file.contentType],
+          ["Created", file.createdAt],
+          ["URL", file.url ?? "(private)"],
+          [
+            "Dimensions",
+            file.width && file.height ? `${file.width}\xD7${file.height}` : "\u2014"
+          ],
+          ["Duration", file.duration ? `${file.duration}s` : "\u2014"],
+          ["Embedding", file.embeddingStatus ?? "\u2014"]
+        ]
+      )
+    ];
+    if (file.metadata && Object.keys(file.metadata).length > 0) {
+      lines.push("\nMetadata:");
+      for (const [k, v] of Object.entries(file.metadata)) {
+        lines.push(`  ${k}: ${v}`);
+      }
+    }
+    return lines.join("\n");
+  });
+}
+async function updateFile(bucket, key, options) {
+  validateBucketName(bucket);
+  validateFileKey(key);
+  const flagMetadata = {};
+  if (options.metadata && options.metadata.length > 0) {
+    for (const pair of options.metadata) {
+      const idx = pair.indexOf("=");
+      if (idx === -1) {
+        console.error(
+          `Error: Invalid metadata format '${pair}'. Use key=value.`
+        );
+        process.exit(1);
+      }
+      flagMetadata[pair.slice(0, idx)] = pair.slice(idx + 1);
+    }
+  }
+  const jsonInput = parseJsonInput(
+    options.inputJson,
+    {}
+  );
+  const hasFlagMetadata = Object.keys(flagMetadata).length > 0;
+  const metadata = hasFlagMetadata ? { ...jsonInput.metadata ?? {}, ...flagMetadata } : jsonInput.metadata;
+  if (!metadata || Object.keys(metadata).length === 0) {
+    console.error(
+      "Error: At least one -m key=value pair or --input-json with metadata is required."
+    );
+    process.exit(1);
+  }
+  if (options.dryRun) {
+    console.log(
+      JSON.stringify(
+        {
+          dryRun: true,
+          action: "updateFile",
+          details: { bucket, key, metadata }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  const stow = createStow();
+  const file = await stow.updateFileMetadata(key, metadata, { bucket });
+  output(file, () => `Updated ${key}`);
+}
+async function enrichFile(bucket, key) {
+  const stow = createStow();
+  const results = await Promise.allSettled([
+    stow.generateTitle(key, { bucket }),
+    stow.generateDescription(key, { bucket }),
+    stow.generateAltText(key, { bucket })
+  ]);
+  const labels = ["Title", "Description", "Alt text"];
+  for (let i = 0; i < results.length; i++) {
+    const result = results[i];
+    const label = labels[i];
+    if (result.status === "fulfilled") {
+      console.log(`  ${label}: triggered`);
+    } else {
+      console.error(`  ${label}: failed \u2014 ${result.reason}`);
+    }
+  }
+  const succeeded = results.filter((r) => r.status === "fulfilled").length;
+  console.log(
+    `
+Enriched ${key}: ${succeeded}/${results.length} tasks dispatched`
+  );
+}
+async function listMissing(bucket, type, options) {
+  const validTypes = ["dimensions", "embeddings", "colors"];
+  if (!validTypes.includes(type)) {
+    console.error(
+      `Error: Invalid type '${type}'. Must be one of: ${validTypes.join(", ")}`
+    );
+    process.exit(1);
+  }
+  const parsedLimit = options.limit ? Number.parseInt(options.limit, 10) : null;
+  const baseUrl = getBaseUrl();
+  const apiKey = getApiKey();
+  const params = new URLSearchParams({
+    bucket,
+    missing: type,
+    ...parsedLimit && Number.isFinite(parsedLimit) && parsedLimit > 0 ? { limit: String(parsedLimit) } : {}
+  });
+  const res = await fetch(`${baseUrl}/files?${params}`, {
+    headers: { "x-api-key": apiKey }
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw new Error(body.error ?? `HTTP ${res.status}`);
+  }
+  const data = await res.json();
+  if (data.files.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(data);
+    } else {
+      console.log(`No files missing ${type} in bucket '${bucket}'.`);
+    }
+    return;
+  }
+  if (options.json || isJsonOutput()) {
+    output(data);
+    return;
+  }
+  const rows = data.files.map((f) => [
+    f.key,
+    formatBytes(f.size),
+    f.lastModified.split("T")[0] ?? f.lastModified
+  ]);
+  console.log(formatTable(["Key", "Size", "Modified"], rows));
+  console.log(`
+${data.files.length} files missing ${type}`);
+}
+export {
+  enrichFile,
+  getFile,
+  listFiles,
+  listMissing,
+  updateFile
+};

package/dist/files-SQURZ7VO.js

@@ -0,0 +1,194 @@
+import {
+  parseJsonInput
+} from "./chunk-XVKIRHTX.js";
+import {
+  validateBucketName,
+  validateFileKey
+} from "./chunk-NBHBVKP5.js";
+import {
+  isJsonOutput,
+  output
+} from "./chunk-KPIQZBTO.js";
+import {
+  formatBytes,
+  formatTable
+} from "./chunk-PE6V3MVP.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import {
+  getApiKey,
+  getBaseUrl
+} from "./chunk-TOADDO2F.js";
+
+// src/commands/files.ts
+async function listFiles(bucket, options) {
+  const stow = createStow();
+  const parsedLimit = options.limit ? Number.parseInt(options.limit, 10) : null;
+  const data = await stow.listFiles({
+    bucket,
+    ...options.search ? { prefix: options.search } : {},
+    ...parsedLimit && Number.isFinite(parsedLimit) && parsedLimit > 0 ? { limit: parsedLimit } : {}
+  });
+  if (data.files.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(data);
+    } else {
+      console.log(`No files in bucket '${bucket}'.`);
+    }
+    return;
+  }
+  if (options.json || isJsonOutput()) {
+    output(data);
+    return;
+  }
+  const rows = data.files.map((f) => [
+    f.key,
+    formatBytes(f.size),
+    f.lastModified.split("T")[0] ?? f.lastModified
+  ]);
+  console.log(formatTable(["Key", "Size", "Modified"], rows));
+  if (data.nextCursor) {
+    console.log("\n(more files available \u2014 use --limit to see more)");
+  }
+}
+async function getFile(bucket, key, _options) {
+  const stow = createStow();
+  const file = await stow.getFile(key, { bucket });
+  output(file, () => {
+    const lines = [
+      formatTable(
+        ["Field", "Value"],
+        [
+          ["Key", file.key],
+          ["Size", formatBytes(file.size)],
+          ["Type", file.contentType],
+          ["Created", file.createdAt],
+          ["URL", file.url ?? "(private)"],
+          ["Dimensions", file.width && file.height ? `${file.width}\xD7${file.height}` : "\u2014"],
+          ["Duration", file.duration ? `${file.duration}s` : "\u2014"],
+          ["Embedding", file.embeddingStatus ?? "\u2014"]
+        ]
+      )
+    ];
+    if (file.metadata && Object.keys(file.metadata).length > 0) {
+      lines.push("\nMetadata:");
+      for (const [k, v] of Object.entries(file.metadata)) {
+        lines.push(`  ${k}: ${v}`);
+      }
+    }
+    return lines.join("\n");
+  });
+}
+async function updateFile(bucket, key, options) {
+  validateBucketName(bucket);
+  validateFileKey(key);
+  const flagMetadata = {};
+  if (options.metadata && options.metadata.length > 0) {
+    for (const pair of options.metadata) {
+      const idx = pair.indexOf("=");
+      if (idx === -1) {
+        console.error(`Error: Invalid metadata format '${pair}'. Use key=value.`);
+        process.exit(1);
+      }
+      flagMetadata[pair.slice(0, idx)] = pair.slice(idx + 1);
+    }
+  }
+  const jsonInput = parseJsonInput(options.inputJson, {});
+  const hasFlagMetadata = Object.keys(flagMetadata).length > 0;
+  const metadata = hasFlagMetadata ? { ...jsonInput.metadata, ...flagMetadata } : jsonInput.metadata;
+  if (!metadata || Object.keys(metadata).length === 0) {
+    console.error(
+      "Error: At least one -m key=value pair or --input-json with metadata is required."
+    );
+    process.exit(1);
+  }
+  if (options.dryRun) {
+    console.log(
+      JSON.stringify(
+        {
+          dryRun: true,
+          action: "updateFile",
+          details: { bucket, key, metadata }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  const stow = createStow();
+  const file = await stow.updateFileMetadata(key, metadata, { bucket });
+  output(file, () => `Updated ${key}`);
+}
+async function enrichFile(bucket, key) {
+  const stow = createStow();
+  const results = await Promise.allSettled([
+    stow.generateTitle(key, { bucket }),
+    stow.generateDescription(key, { bucket }),
+    stow.generateAltText(key, { bucket })
+  ]);
+  const labels = ["Title", "Description", "Alt text"];
+  for (let i = 0; i < results.length; i += 1) {
+    const result = results[i];
+    const label = labels[i];
+    if (result.status === "fulfilled") {
+      console.log(`  ${label}: triggered`);
+    } else {
+      console.error(`  ${label}: failed \u2014 ${result.reason}`);
+    }
+  }
+  const succeeded = results.filter((r) => r.status === "fulfilled").length;
+  console.log(`
+Enriched ${key}: ${succeeded}/${results.length} tasks dispatched`);
+}
+async function listMissing(bucket, type, options) {
+  const validTypes = ["dimensions", "embeddings", "colors"];
+  if (!validTypes.includes(type)) {
+    console.error(`Error: Invalid type '${type}'. Must be one of: ${validTypes.join(", ")}`);
+    process.exit(1);
+  }
+  const parsedLimit = options.limit ? Number.parseInt(options.limit, 10) : null;
+  const baseUrl = getBaseUrl();
+  const apiKey = getApiKey();
+  const params = new URLSearchParams({
+    bucket,
+    missing: type,
+    ...parsedLimit && Number.isFinite(parsedLimit) && parsedLimit > 0 ? { limit: String(parsedLimit) } : {}
+  });
+  const res = await fetch(`${baseUrl}/files?${params}`, {
+    headers: { "x-api-key": apiKey }
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw new Error(body.error ?? `HTTP ${res.status}`);
+  }
+  const data = await res.json();
+  if (data.files.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(data);
+    } else {
+      console.log(`No files missing ${type} in bucket '${bucket}'.`);
+    }
+    return;
+  }
+  if (options.json || isJsonOutput()) {
+    output(data);
+    return;
+  }
+  const rows = data.files.map((f) => [
+    f.key,
+    formatBytes(f.size),
+    f.lastModified.split("T")[0] ?? f.lastModified
+  ]);
+  console.log(formatTable(["Key", "Size", "Modified"], rows));
+  console.log(`
+${data.files.length} files missing ${type}`);
+}
+export {
+  enrichFile,
+  getFile,
+  listFiles,
+  listMissing,
+  updateFile
+};