stow-cli 1.0.0 → 1.0.2

package/dist/app-XPOEAZJC.js

@@ -0,0 +1,239 @@
+import {
+  apiRequest
+} from "./chunk-LYCXXF2T.js";
+import {
+  formatBytes
+} from "./chunk-ZDVARBCV.js";
+import "./chunk-OZ7QQTIZ.js";
+
+// src/interactive/app.tsx
+import { render } from "ink";
+import { useEffect as useEffect3, useState as useState3 } from "react";
+
+// src/interactive/components/bucket-list.tsx
+import { Box as Box3, Text as Text3, useApp, useInput } from "ink";
+import Spinner from "ink-spinner";
+import { useEffect, useState } from "react";
+
+// src/interactive/components/header.tsx
+import { Box, Text } from "ink";
+import { jsx, jsxs } from "react/jsx-runtime";
+function Header({ path, email, size }) {
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs(Box, { justifyContent: "space-between", width: "100%", children: [
+      /* @__PURE__ */ jsxs(Text, { bold: true, children: [
+        "STOW",
+        path ? ` > ${path}` : ""
+      ] }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: size || email || "" })
+    ] }),
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: "\u2500".repeat(50) })
+  ] });
+}
+
+// src/interactive/components/status-bar.tsx
+import { Box as Box2, Text as Text2 } from "ink";
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function StatusBar({ hints }) {
+  return /* @__PURE__ */ jsx2(Box2, { marginTop: 1, children: hints.map((h, i) => /* @__PURE__ */ jsx2(Box2, { marginRight: 2, children: /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
+    "[",
+    h.key,
+    "]",
+    h.label,
+    i < hints.length - 1 ? "" : ""
+  ] }) }, h.key)) });
+}
+
+// src/interactive/components/bucket-list.tsx
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+function BucketList({ onSelect, email }) {
+  const { exit } = useApp();
+  const [buckets, setBuckets] = useState([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const [cursor, setCursor] = useState(0);
+  useEffect(() => {
+    apiRequest("/api/buckets").then((data) => {
+      setBuckets(data.buckets);
+      setLoading(false);
+    }).catch((err) => {
+      setError(err instanceof Error ? err.message : String(err));
+      setLoading(false);
+    });
+  }, []);
+  useInput((input, key) => {
+    if (input === "q") {
+      exit();
+      return;
+    }
+    if (key.upArrow) {
+      setCursor((c) => Math.max(0, c - 1));
+    } else if (key.downArrow) {
+      setCursor((c) => Math.min(buckets.length - 1, c + 1));
+    } else if (key.return && buckets.length > 0) {
+      onSelect(buckets[cursor]);
+    }
+  });
+  if (loading) {
+    return /* @__PURE__ */ jsx3(Box3, { children: /* @__PURE__ */ jsxs3(Text3, { children: [
+      /* @__PURE__ */ jsx3(Spinner, { type: "dots" }),
+      " Loading buckets..."
+    ] }) });
+  }
+  if (error) {
+    return /* @__PURE__ */ jsx3(Box3, { flexDirection: "column", children: /* @__PURE__ */ jsxs3(Text3, { color: "red", children: [
+      "Error: ",
+      error
+    ] }) });
+  }
+  return /* @__PURE__ */ jsxs3(Box3, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx3(Header, { email }),
+    buckets.length === 0 ? /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: "No buckets yet. Press 'n' to create one." }) : buckets.map((b, i) => /* @__PURE__ */ jsx3(Box3, { children: /* @__PURE__ */ jsxs3(Text3, { color: i === cursor ? "cyan" : void 0, children: [
+      i === cursor ? "\u25B8 " : "  ",
+      b.name.padEnd(20),
+      `${b.fileCount} files`.padEnd(14),
+      formatBytes(b.usageBytes)
+    ] }) }, b.id)),
+    /* @__PURE__ */ jsx3(
+      StatusBar,
+      {
+        hints: [
+          { key: "\u2191\u2193", label: "navigate" },
+          { key: "\u21B5", label: "open" },
+          { key: "q", label: "uit" }
+        ]
+      }
+    )
+  ] });
+}
+
+// src/interactive/components/file-list.tsx
+import { Box as Box4, Text as Text4, useInput as useInput2 } from "ink";
+import Spinner2 from "ink-spinner";
+import { useEffect as useEffect2, useState as useState2 } from "react";
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+function FileList({ bucket, onBack }) {
+  const [files, setFiles] = useState2([]);
+  const [loading, setLoading] = useState2(true);
+  const [error, setError] = useState2(null);
+  const [cursor, setCursor] = useState2(0);
+  const [nextCursor, setNextCursor] = useState2(null);
+  const [copied, setCopied] = useState2(false);
+  useEffect2(() => {
+    loadFiles();
+  }, []);
+  function loadFiles(pageCursor) {
+    setLoading(true);
+    const params = new URLSearchParams({ bucket: bucket.name });
+    if (pageCursor) {
+      params.set("cursor", pageCursor);
+    }
+    apiRequest(
+      `/api/files?${params}`
+    ).then((data) => {
+      setFiles(
+        (prev) => pageCursor ? [...prev, ...data.files] : data.files
+      );
+      setNextCursor(data.nextCursor);
+      setLoading(false);
+    }).catch((err) => {
+      setError(err instanceof Error ? err.message : String(err));
+      setLoading(false);
+    });
+  }
+  useInput2((input, key) => {
+    if (key.escape || key.backspace || key.leftArrow && !loading) {
+      onBack();
+      return;
+    }
+    if (key.upArrow) {
+      setCursor((c) => Math.max(0, c - 1));
+    } else if (key.downArrow) {
+      setCursor((c) => {
+        const next = Math.min(files.length - 1, c + 1);
+        if (next >= files.length - 3 && nextCursor && !loading) {
+          loadFiles(nextCursor);
+        }
+        return next;
+      });
+    } else if (input === "c" && files.length > 0) {
+      import("clipboardy").then(({ default: clipboard }) => {
+        clipboard.write(files[cursor].url).then(() => {
+          setCopied(true);
+          setTimeout(() => setCopied(false), 2e3);
+        });
+      });
+    }
+  });
+  if (error) {
+    return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsxs4(Text4, { color: "red", children: [
+        "Error: ",
+        error
+      ] }),
+      /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: "Press Esc to go back." })
+    ] });
+  }
+  return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx4(Header, { path: bucket.name, size: formatBytes(bucket.usageBytes) }),
+    loading && files.length === 0 && /* @__PURE__ */ jsxs4(Text4, { children: [
+      /* @__PURE__ */ jsx4(Spinner2, { type: "dots" }),
+      " Loading files..."
+    ] }),
+    !loading && files.length === 0 && /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: "No files in this bucket." }),
+    files.length > 0 && files.map((f, i) => /* @__PURE__ */ jsx4(Box4, { children: /* @__PURE__ */ jsxs4(Text4, { color: i === cursor ? "cyan" : void 0, children: [
+      i === cursor ? "\u25B8 " : "  ",
+      f.key.padEnd(28),
+      formatBytes(f.size).padEnd(10),
+      f.lastModified.split("T")[0]
+    ] }) }, f.key)),
+    loading && files.length > 0 && /* @__PURE__ */ jsxs4(Text4, { dimColor: true, children: [
+      /* @__PURE__ */ jsx4(Spinner2, { type: "dots" }),
+      " Loading more..."
+    ] }),
+    copied && /* @__PURE__ */ jsx4(Text4, { color: "green", children: "Copied URL to clipboard!" }),
+    /* @__PURE__ */ jsx4(
+      StatusBar,
+      {
+        hints: [
+          { key: "\u2191\u2193", label: "navigate" },
+          { key: "c", label: "opy url" },
+          { key: "\u2190", label: "back" }
+        ]
+      }
+    )
+  ] });
+}
+
+// src/interactive/app.tsx
+import { jsx as jsx5 } from "react/jsx-runtime";
+function App() {
+  const [screen, setScreen] = useState3({ type: "buckets" });
+  const [email, setEmail] = useState3();
+  useEffect3(() => {
+    apiRequest("/api/whoami").then((data) => setEmail(data.user.email)).catch(() => {
+    });
+  }, []);
+  if (screen.type === "files") {
+    return /* @__PURE__ */ jsx5(
+      FileList,
+      {
+        bucket: screen.bucket,
+        onBack: () => setScreen({ type: "buckets" })
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx5(
+    BucketList,
+    {
+      email,
+      onSelect: (bucket) => setScreen({ type: "files", bucket })
+    }
+  );
+}
+function startInteractive() {
+  render(/* @__PURE__ */ jsx5(App, {}));
+}
+export {
+  startInteractive
+};

package/dist/app-YITP5APT.js

@@ -0,0 +1,233 @@
+import {
+  formatBytes
+} from "./chunk-MHRMBH4Y.js";
+import {
+  apiRequest
+} from "./chunk-YRHPOFJT.js";
+import "./chunk-2AORPTQB.js";
+
+// src/interactive/app.tsx
+import { useState as useState3, useEffect as useEffect3 } from "react";
+import { render } from "ink";
+
+// src/interactive/components/bucket-list.tsx
+import { useState, useEffect } from "react";
+import { Box as Box3, Text as Text3, useInput, useApp } from "ink";
+import Spinner from "ink-spinner";
+
+// src/interactive/components/header.tsx
+import { Box, Text } from "ink";
+import { jsx, jsxs } from "react/jsx-runtime";
+function Header({ path, email, size }) {
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs(Box, { justifyContent: "space-between", width: "100%", children: [
+      /* @__PURE__ */ jsxs(Text, { bold: true, children: [
+        "STOW",
+        path ? ` > ${path}` : ""
+      ] }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: size || email || "" })
+    ] }),
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: "\u2500".repeat(50) })
+  ] });
+}
+
+// src/interactive/components/status-bar.tsx
+import { Box as Box2, Text as Text2 } from "ink";
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function StatusBar({ hints }) {
+  return /* @__PURE__ */ jsx2(Box2, { marginTop: 1, children: hints.map((h, i) => /* @__PURE__ */ jsx2(Box2, { marginRight: 2, children: /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
+    "[",
+    h.key,
+    "]",
+    h.label,
+    i < hints.length - 1 ? "" : ""
+  ] }) }, h.key)) });
+}
+
+// src/interactive/components/bucket-list.tsx
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+function BucketList({ onSelect, email }) {
+  const { exit } = useApp();
+  const [buckets, setBuckets] = useState([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const [cursor, setCursor] = useState(0);
+  useEffect(() => {
+    apiRequest("/api/buckets").then((data) => {
+      setBuckets(data.buckets);
+      setLoading(false);
+    }).catch((err) => {
+      setError(err instanceof Error ? err.message : String(err));
+      setLoading(false);
+    });
+  }, []);
+  useInput((input, key) => {
+    if (input === "q") {
+      exit();
+      return;
+    }
+    if (key.upArrow) {
+      setCursor((c) => Math.max(0, c - 1));
+    } else if (key.downArrow) {
+      setCursor((c) => Math.min(buckets.length - 1, c + 1));
+    } else if (key.return && buckets.length > 0) {
+      onSelect(buckets[cursor]);
+    }
+  });
+  if (loading) {
+    return /* @__PURE__ */ jsx3(Box3, { children: /* @__PURE__ */ jsxs3(Text3, { children: [
+      /* @__PURE__ */ jsx3(Spinner, { type: "dots" }),
+      " Loading buckets..."
+    ] }) });
+  }
+  if (error) {
+    return /* @__PURE__ */ jsx3(Box3, { flexDirection: "column", children: /* @__PURE__ */ jsxs3(Text3, { color: "red", children: [
+      "Error: ",
+      error
+    ] }) });
+  }
+  return /* @__PURE__ */ jsxs3(Box3, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx3(Header, { email }),
+    buckets.length === 0 ? /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: "No buckets yet. Press 'n' to create one." }) : buckets.map((b, i) => /* @__PURE__ */ jsx3(Box3, { children: /* @__PURE__ */ jsxs3(Text3, { color: i === cursor ? "cyan" : void 0, children: [
+      i === cursor ? "\u25B8 " : "  ",
+      b.name.padEnd(20),
+      `${b.fileCount} files`.padEnd(14),
+      formatBytes(b.usageBytes)
+    ] }) }, b.id)),
+    /* @__PURE__ */ jsx3(
+      StatusBar,
+      {
+        hints: [
+          { key: "\u2191\u2193", label: "navigate" },
+          { key: "\u21B5", label: "open" },
+          { key: "q", label: "uit" }
+        ]
+      }
+    )
+  ] });
+}
+
+// src/interactive/components/file-list.tsx
+import { useState as useState2, useEffect as useEffect2 } from "react";
+import { Box as Box4, Text as Text4, useInput as useInput2 } from "ink";
+import Spinner2 from "ink-spinner";
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+function FileList({ bucket, onBack }) {
+  const [files, setFiles] = useState2([]);
+  const [loading, setLoading] = useState2(true);
+  const [error, setError] = useState2(null);
+  const [cursor, setCursor] = useState2(0);
+  const [nextCursor, setNextCursor] = useState2(null);
+  const [copied, setCopied] = useState2(false);
+  useEffect2(() => {
+    loadFiles();
+  }, []);
+  function loadFiles(pageCursor) {
+    setLoading(true);
+    const params = new URLSearchParams({ bucket: bucket.name });
+    if (pageCursor) params.set("cursor", pageCursor);
+    apiRequest(
+      `/api/files?${params}`
+    ).then((data) => {
+      setFiles((prev) => pageCursor ? [...prev, ...data.files] : data.files);
+      setNextCursor(data.nextCursor);
+      setLoading(false);
+    }).catch((err) => {
+      setError(err instanceof Error ? err.message : String(err));
+      setLoading(false);
+    });
+  }
+  useInput2((input, key) => {
+    if (key.escape || key.backspace || key.leftArrow && !loading) {
+      onBack();
+      return;
+    }
+    if (key.upArrow) {
+      setCursor((c) => Math.max(0, c - 1));
+    } else if (key.downArrow) {
+      setCursor((c) => {
+        const next = Math.min(files.length - 1, c + 1);
+        if (next >= files.length - 3 && nextCursor && !loading) {
+          loadFiles(nextCursor);
+        }
+        return next;
+      });
+    } else if (input === "c" && files.length > 0) {
+      import("clipboardy").then(({ default: clipboard }) => {
+        clipboard.write(files[cursor].url).then(() => {
+          setCopied(true);
+          setTimeout(() => setCopied(false), 2e3);
+        });
+      });
+    }
+  });
+  if (error) {
+    return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsxs4(Text4, { color: "red", children: [
+        "Error: ",
+        error
+      ] }),
+      /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: "Press Esc to go back." })
+    ] });
+  }
+  return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx4(Header, { path: bucket.name, size: formatBytes(bucket.usageBytes) }),
+    loading && files.length === 0 ? /* @__PURE__ */ jsxs4(Text4, { children: [
+      /* @__PURE__ */ jsx4(Spinner2, { type: "dots" }),
+      " Loading files..."
+    ] }) : files.length === 0 ? /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: "No files in this bucket." }) : files.map((f, i) => /* @__PURE__ */ jsx4(Box4, { children: /* @__PURE__ */ jsxs4(Text4, { color: i === cursor ? "cyan" : void 0, children: [
+      i === cursor ? "\u25B8 " : "  ",
+      f.key.padEnd(28),
+      formatBytes(f.size).padEnd(10),
+      f.lastModified.split("T")[0]
+    ] }) }, f.key)),
+    loading && files.length > 0 && /* @__PURE__ */ jsxs4(Text4, { dimColor: true, children: [
+      /* @__PURE__ */ jsx4(Spinner2, { type: "dots" }),
+      " Loading more..."
+    ] }),
+    copied && /* @__PURE__ */ jsx4(Text4, { color: "green", children: "Copied URL to clipboard!" }),
+    /* @__PURE__ */ jsx4(
+      StatusBar,
+      {
+        hints: [
+          { key: "\u2191\u2193", label: "navigate" },
+          { key: "c", label: "opy url" },
+          { key: "\u2190", label: "back" }
+        ]
+      }
+    )
+  ] });
+}
+
+// src/interactive/app.tsx
+import { jsx as jsx5 } from "react/jsx-runtime";
+function App() {
+  const [screen, setScreen] = useState3({ type: "buckets" });
+  const [email, setEmail] = useState3();
+  useEffect3(() => {
+    apiRequest("/api/whoami").then((data) => setEmail(data.user.email)).catch(() => {
+    });
+  }, []);
+  if (screen.type === "files") {
+    return /* @__PURE__ */ jsx5(
+      FileList,
+      {
+        bucket: screen.bucket,
+        onBack: () => setScreen({ type: "buckets" })
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx5(
+    BucketList,
+    {
+      email,
+      onSelect: (bucket) => setScreen({ type: "files", bucket })
+    }
+  );
+}
+function startInteractive() {
+  render(/* @__PURE__ */ jsx5(App, {}));
+}
+export {
+  startInteractive
+};

package/dist/chunk-2AORPTQB.js

@@ -0,0 +1,23 @@
+// src/lib/config.ts
+var DEFAULT_BASE_URL = "https://stow.sh";
+function getApiKey() {
+  const key = process.env.STOW_API_KEY;
+  if (!key) {
+    console.error("Error: STOW_API_KEY environment variable not set");
+    console.error("");
+    console.error("Set your API key:");
+    console.error("  export STOW_API_KEY=stow_...");
+    console.error("");
+    console.error("Get an API key at https://stow.sh/dashboard/api-keys");
+    process.exit(1);
+  }
+  return key;
+}
+function getBaseUrl() {
+  return process.env.STOW_API_URL || DEFAULT_BASE_URL;
+}
+
+export {
+  getApiKey,
+  getBaseUrl
+};

package/dist/chunk-FEMMZ4YZ.js

@@ -0,0 +1,125 @@
+import {
+  getApiKey,
+  getBaseUrl
+} from "./chunk-2AORPTQB.js";
+
+// src/lib/api.ts
+var StowApiError = class extends Error {
+  status;
+  code;
+  constructor(status, message, code) {
+    super(message);
+    this.name = "StowApiError";
+    this.status = status;
+    this.code = code;
+  }
+};
+function formatApiError(status, message) {
+  switch (status) {
+    case 401:
+      return "Invalid API key. Set STOW_API_KEY or get one at stow.sh/dashboard/api-keys";
+    case 403:
+      return message || "Permission denied";
+    case 404:
+      return message || "Not found";
+    case 413:
+      return "File too large (max 50MB)";
+    case 429:
+      return "Rate limit exceeded. Try again shortly.";
+    default:
+      return message || `Request failed (${status})`;
+  }
+}
+async function apiRequest(path, options = {}) {
+  const apiKey = getApiKey();
+  const baseUrl = getBaseUrl();
+  const url = `${baseUrl}${path}`;
+  const headers = {
+    "x-api-key": apiKey,
+    ...options.headers || {}
+  };
+  if (options.body && typeof options.body === "string") {
+    headers["Content-Type"] = "application/json";
+  }
+  let response;
+  try {
+    response = await fetch(url, { ...options, headers });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes("ECONNREFUSED")) {
+      throw new StowApiError(
+        0,
+        `Cannot connect to ${baseUrl}. Is the server running?`
+      );
+    }
+    if (msg.includes("ENOTFOUND")) {
+      throw new StowApiError(
+        0,
+        `Cannot resolve ${baseUrl}. Check your STOW_API_URL or internet connection.`
+      );
+    }
+    throw new StowApiError(0, `Network error: ${msg}`);
+  }
+  if (!response.ok) {
+    const data = await response.json().catch(() => ({}));
+    const serverMsg = data.error;
+    const code = data.code;
+    throw new StowApiError(
+      response.status,
+      formatApiError(response.status, serverMsg || ""),
+      code
+    );
+  }
+  return await response.json();
+}
+async function apiUpload(path, fileBuffer, filename, contentType) {
+  const apiKey = getApiKey();
+  const baseUrl = getBaseUrl();
+  const boundary = `----stow${Date.now()}`;
+  const parts = [];
+  parts.push(Buffer.from(`--${boundary}\r
+`));
+  parts.push(
+    Buffer.from(
+      `Content-Disposition: form-data; name="file"; filename="${filename}"\r
+`
+    )
+  );
+  parts.push(Buffer.from(`Content-Type: ${contentType}\r
+\r
+`));
+  parts.push(fileBuffer);
+  parts.push(Buffer.from(`\r
+--${boundary}--\r
+`));
+  const body = Buffer.concat(parts);
+  let response;
+  try {
+    response = await fetch(`${baseUrl}${path}`, {
+      method: "POST",
+      headers: {
+        "x-api-key": apiKey,
+        "Content-Type": `multipart/form-data; boundary=${boundary}`
+      },
+      body
+    });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new StowApiError(0, `Network error: ${msg}`);
+  }
+  if (!response.ok) {
+    const data = await response.json().catch(() => ({}));
+    const serverMsg = data.error;
+    throw new StowApiError(
+      response.status,
+      formatApiError(response.status, serverMsg || "")
+    );
+  }
+  return await response.json();
+}
+
+export {
+  StowApiError,
+  apiRequest,
+  apiUpload
+};

package/dist/chunk-LYCXXF2T.js

@@ -0,0 +1,79 @@
+import {
+  getApiKey,
+  getBaseUrl
+} from "./chunk-OZ7QQTIZ.js";
+
+// src/lib/api.ts
+var StowApiError = class extends Error {
+  status;
+  code;
+  constructor(status, message, code) {
+    super(message);
+    this.name = "StowApiError";
+    this.status = status;
+    this.code = code;
+  }
+};
+function formatApiError(status, message) {
+  switch (status) {
+    case 401:
+      return "Invalid API key. Set STOW_API_KEY or get one at stow.sh/dashboard/api-keys";
+    case 403:
+      return message || "Permission denied";
+    case 404:
+      return message || "Not found";
+    case 413:
+      return "File too large (max 50MB)";
+    case 429:
+      return "Rate limit exceeded. Try again shortly.";
+    default:
+      return message || `Request failed (${status})`;
+  }
+}
+async function apiRequest(path, options = {}) {
+  const apiKey = getApiKey();
+  const baseUrl = getBaseUrl();
+  const url = `${baseUrl}${path}`;
+  const headers = {
+    "x-api-key": apiKey,
+    ...options.headers || {}
+  };
+  if (options.body && typeof options.body === "string") {
+    headers["Content-Type"] = "application/json";
+  }
+  let response;
+  try {
+    response = await fetch(url, { ...options, headers });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes("ECONNREFUSED")) {
+      throw new StowApiError(
+        0,
+        `Cannot connect to ${baseUrl}. Is the server running?`
+      );
+    }
+    if (msg.includes("ENOTFOUND")) {
+      throw new StowApiError(
+        0,
+        `Cannot resolve ${baseUrl}. Check your STOW_API_URL or internet connection.`
+      );
+    }
+    throw new StowApiError(0, `Network error: ${msg}`);
+  }
+  if (!response.ok) {
+    const data = await response.json().catch(() => ({}));
+    const serverMsg = data.error;
+    const code = data.code;
+    throw new StowApiError(
+      response.status,
+      formatApiError(response.status, serverMsg || ""),
+      code
+    );
+  }
+  return await response.json();
+}
+
+export {
+  StowApiError,
+  apiRequest
+};