@howells/stow-server 0.7.0 → 2.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Stow
+
+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.

package/dist/index.d.mts

@@ -520,10 +520,12 @@ interface SearchResultItem {
         name: string;
     }>;
     taxonomies?: Array<{
-        slug: string;
-        name: string;
+        externalUri: string | null;
         group: string;
+        name: string;
         similarity: number;
+        slug: string;
+        source: string;
     }>;
     width?: number | null;
 }
@@ -938,19 +940,19 @@ declare class StowServer {
      */
     get profiles(): {
         create: (params?: ProfileCreateRequest) => Promise<ProfileResult>;
-        get: (id: string) => Promise<ProfileResult>;
-        delete: (id: string) => Promise<void>;
+        get: (id: string, bucket?: string) => Promise<ProfileResult>;
+        delete: (id: string, bucket?: string) => Promise<void>;
         addFiles: (id: string, fileKeys: string[], bucket?: string) => Promise<ProfileFilesResult>;
         removeFiles: (id: string, fileKeys: string[], bucket?: string) => Promise<ProfileFilesResult>;
         signal: (id: string, signals: ProfileSignalInput[], bucket?: string) => Promise<ProfileSignalsResponse>;
-        deleteSignals: (id: string, signalIds: string[]) => Promise<DeleteProfileSignalsResult>;
-        clusters: (id: string) => Promise<{
+        deleteSignals: (id: string, signalIds: string[], bucket?: string) => Promise<DeleteProfileSignalsResult>;
+        clusters: (id: string, bucket?: string) => Promise<{
             profileId: string;
             signalCount: number;
             clusters: ProfileClusterResult[];
         }>;
-        recluster: (id: string, params?: ReclusterRequest) => Promise<ReclusterResult>;
-        renameCluster: (profileId: string, clusterId: string, params: RenameClusterRequest) => Promise<ProfileClusterResult>;
+        recluster: (id: string, params?: ReclusterRequest, bucket?: string) => Promise<ReclusterResult>;
+        renameCluster: (profileId: string, clusterId: string, params: RenameClusterRequest, bucket?: string) => Promise<ProfileClusterResult>;
     };
     private createProfile;
     private getProfile;

package/dist/index.d.ts

@@ -520,10 +520,12 @@ interface SearchResultItem {
         name: string;
     }>;
     taxonomies?: Array<{
-        slug: string;
-        name: string;
+        externalUri: string | null;
         group: string;
+        name: string;
         similarity: number;
+        slug: string;
+        source: string;
     }>;
     width?: number | null;
 }
@@ -938,19 +940,19 @@ declare class StowServer {
      */
     get profiles(): {
         create: (params?: ProfileCreateRequest) => Promise<ProfileResult>;
-        get: (id: string) => Promise<ProfileResult>;
-        delete: (id: string) => Promise<void>;
+        get: (id: string, bucket?: string) => Promise<ProfileResult>;
+        delete: (id: string, bucket?: string) => Promise<void>;
         addFiles: (id: string, fileKeys: string[], bucket?: string) => Promise<ProfileFilesResult>;
         removeFiles: (id: string, fileKeys: string[], bucket?: string) => Promise<ProfileFilesResult>;
         signal: (id: string, signals: ProfileSignalInput[], bucket?: string) => Promise<ProfileSignalsResponse>;
-        deleteSignals: (id: string, signalIds: string[]) => Promise<DeleteProfileSignalsResult>;
-        clusters: (id: string) => Promise<{
+        deleteSignals: (id: string, signalIds: string[], bucket?: string) => Promise<DeleteProfileSignalsResult>;
+        clusters: (id: string, bucket?: string) => Promise<{
             profileId: string;
             signalCount: number;
             clusters: ProfileClusterResult[];
         }>;
-        recluster: (id: string, params?: ReclusterRequest) => Promise<ReclusterResult>;
-        renameCluster: (profileId: string, clusterId: string, params: RenameClusterRequest) => Promise<ProfileClusterResult>;
+        recluster: (id: string, params?: ReclusterRequest, bucket?: string) => Promise<ReclusterResult>;
+        renameCluster: (profileId: string, clusterId: string, params: RenameClusterRequest, bucket?: string) => Promise<ProfileClusterResult>;
     };
     private createProfile;
     private getProfile;

package/dist/index.js

@@ -294,12 +294,12 @@ var StowServer = class {
   constructor(config) {
     if (typeof config === "string") {
       this.apiKey = config;
-      this.baseUrl = "https://app.stow.sh";
+      this.baseUrl = "https://api.stow.sh";
       this.timeout = 3e4;
       this.retries = 3;
     } else {
       this.apiKey = config.apiKey;
-      this.baseUrl = config.baseUrl || "https://app.stow.sh";
+      this.baseUrl = config.baseUrl || "https://api.stow.sh";
       this.bucket = config.bucket;
       this.timeout = config.timeout ?? 3e4;
       this.retries = config.retries ?? 3;
@@ -315,20 +315,20 @@ var StowServer = class {
    * Return account usage and API key info for the current credential.
    */
   whoami() {
-    return this.request("/api/whoami", { method: "GET" }, whoamiSchema);
+    return this.request("/whoami", { method: "GET" }, whoamiSchema);
   }
   /**
    * List all buckets available to the current organization.
    */
   listBuckets() {
-    return this.request("/api/buckets", { method: "GET" }, listBucketsSchema);
+    return this.request("/buckets", { method: "GET" }, listBucketsSchema);
   }
   /**
    * Create a new bucket.
    */
   async createBucket(request) {
     const result = await this.request(
-      "/api/buckets",
+      "/buckets",
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -343,7 +343,7 @@ var StowServer = class {
    */
   async getBucket(id) {
     const result = await this.request(
-      `/api/buckets/${encodeURIComponent(id)}`,
+      `/buckets/${encodeURIComponent(id)}`,
       { method: "GET" },
       bucketResponseSchema
     );
@@ -354,7 +354,7 @@ var StowServer = class {
    */
   async updateBucket(id, updates) {
     const result = await this.request(
-      `/api/buckets/${encodeURIComponent(id)}`,
+      `/buckets/${encodeURIComponent(id)}`,
       {
         method: "PATCH",
         headers: { "Content-Type": "application/json" },
@@ -369,7 +369,7 @@ var StowServer = class {
    */
   async updateBucketByName(name, updates) {
     const result = await this.request(
-      `/api/buckets/_?bucket=${encodeURIComponent(name)}`,
+      `/buckets/_?bucket=${encodeURIComponent(name)}`,
       {
         method: "PATCH",
         headers: { "Content-Type": "application/json" },
@@ -389,7 +389,7 @@ var StowServer = class {
    * Delete a bucket by id.
    */
   async deleteBucket(id) {
-    await this.request(`/api/buckets/${encodeURIComponent(id)}`, {
+    await this.request(`/buckets/${encodeURIComponent(id)}`, {
       method: "DELETE"
     });
   }
@@ -517,7 +517,7 @@ var StowServer = class {
     }
     return this.request(
       this.withBucket(
-        presign.confirmUrl || "/api/presign/confirm",
+        presign.confirmUrl || "/presign/confirm",
         options?.bucket
       ),
       {
@@ -543,7 +543,7 @@ var StowServer = class {
    */
   async uploadFromUrl(url, filename, options) {
     const result = await this.request(
-      this.withBucket("/api/upload", options?.bucket),
+      this.withBucket("/upload", options?.bucket),
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -576,7 +576,7 @@ var StowServer = class {
    */
   async queueUploadFromUrl(url, filename, options) {
     return this.request(
-      this.withBucket("/api/upload", options?.bucket),
+      this.withBucket("/upload", options?.bucket),
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -614,7 +614,7 @@ var StowServer = class {
       contentHash
     } = request;
     return this.request(
-      this.withBucket("/api/presign", bucket),
+      this.withBucket("/presign", bucket),
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -648,7 +648,7 @@ var StowServer = class {
       altText
     } = request;
     return this.request(
-      this.withBucket("/api/presign/confirm", bucket),
+      this.withBucket("/presign/confirm", bucket),
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -689,7 +689,7 @@ var StowServer = class {
     if (options?.include?.length) {
       params.set("include", options.include.join(","));
     }
-    const path = `/api/files?${params}`;
+    const path = `/files?${params}`;
     return this.request(
       this.withBucket(path, options?.bucket),
       { method: "GET" },
@@ -700,7 +700,7 @@ var StowServer = class {
    * Delete a file by key
    */
   async deleteFile(key, options) {
-    const path = `/api/files/${encodeURIComponent(key)}`;
+    const path = `/files/${encodeURIComponent(key)}`;
     await this.request(this.withBucket(path, options?.bucket), {
       method: "DELETE"
     });
@@ -709,7 +709,7 @@ var StowServer = class {
    * Update metadata on an existing file
    */
   updateFileMetadata(key, metadata, options) {
-    const path = `/api/files/${encodeURIComponent(key)}`;
+    const path = `/files/${encodeURIComponent(key)}`;
     return this.request(this.withBucket(path, options?.bucket), {
       method: "PATCH",
       headers: { "Content-Type": "application/json" },
@@ -727,7 +727,7 @@ var StowServer = class {
       params.set("include", options.include.join(","));
     }
     const qs = params.toString();
-    const path = `/api/files/${encodeURIComponent(key)}${qs ? `?${qs}` : ""}`;
+    const path = `/files/${encodeURIComponent(key)}${qs ? `?${qs}` : ""}`;
     return this.request(
       this.withBucket(path, options?.bucket),
       { method: "GET" },
@@ -739,7 +739,7 @@ var StowServer = class {
    * Requires a searchable bucket.
    */
   extractColors(key, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/colors`;
+    const path = `/files/${encodeURIComponent(key)}/colors`;
     return this.request(
       this.withBucket(path, options?.bucket),
       { method: "POST" },
@@ -750,7 +750,7 @@ var StowServer = class {
    * Extract dimensions (width/height) from an image or video file.
    */
   extractDimensions(key, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/dimensions`;
+    const path = `/files/${encodeURIComponent(key)}/dimensions`;
     return this.request(
       this.withBucket(path, options?.bucket),
       { method: "POST" },
@@ -762,7 +762,7 @@ var StowServer = class {
    * Requires a searchable bucket.
    */
   embed(key, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/embedding`;
+    const path = `/files/${encodeURIComponent(key)}/embedding`;
     return this.request(
       this.withBucket(path, options?.bucket),
       { method: "POST" },
@@ -774,7 +774,7 @@ var StowServer = class {
    * Requires a searchable bucket.
    */
   generateTitle(key, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/title`;
+    const path = `/files/${encodeURIComponent(key)}/title`;
     return this.request(
       this.withBucket(path, options?.bucket),
       { method: "POST" },
@@ -786,7 +786,7 @@ var StowServer = class {
    * Requires a searchable bucket.
    */
   generateDescription(key, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/description`;
+    const path = `/files/${encodeURIComponent(key)}/description`;
     return this.request(
       this.withBucket(path, options?.bucket),
       { method: "POST" },
@@ -798,7 +798,7 @@ var StowServer = class {
    * Requires a searchable bucket.
    */
   generateAltText(key, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/alt-text`;
+    const path = `/files/${encodeURIComponent(key)}/alt-text`;
     return this.request(
       this.withBucket(path, options?.bucket),
       { method: "POST" },
@@ -813,7 +813,7 @@ var StowServer = class {
    * tasks are re-dispatched as if the file were newly uploaded.
    */
   replaceFile(key, url, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/replace`;
+    const path = `/files/${encodeURIComponent(key)}/replace`;
     return this.request(
       this.withBucket(path, options?.bucket),
       {
@@ -870,17 +870,17 @@ var StowServer = class {
     };
   }
   listTags() {
-    return this.request("/api/tags", { method: "GET" });
+    return this.request("/tags", { method: "GET" });
   }
   createTag(params) {
-    return this.request("/api/tags", {
+    return this.request("/tags", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify(params)
     });
   }
   async deleteTag(id) {
-    await this.request(`/api/tags/${encodeURIComponent(id)}`, {
+    await this.request(`/tags/${encodeURIComponent(id)}`, {
       method: "DELETE"
     });
   }
@@ -891,7 +891,7 @@ var StowServer = class {
    * Add tags to a file
    */
   async addTags(key, tagIds, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/tags`;
+    const path = `/files/${encodeURIComponent(key)}/tags`;
     await this.request(this.withBucket(path, options?.bucket), {
       method: "POST",
       headers: { "Content-Type": "application/json" },
@@ -902,7 +902,7 @@ var StowServer = class {
    * Remove a tag from a file
    */
   async removeTag(key, tagId, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/tags/${encodeURIComponent(tagId)}`;
+    const path = `/files/${encodeURIComponent(key)}/tags/${encodeURIComponent(tagId)}`;
     await this.request(this.withBucket(path, options?.bucket), {
       method: "DELETE"
     });
@@ -927,7 +927,7 @@ var StowServer = class {
     };
   }
   listTaxonomies() {
-    return this.request("/api/taxonomies", { method: "GET" });
+    return this.request("/taxonomies", { method: "GET" });
   }
   // ============================================================
   // SEARCH - Vector similarity search
@@ -945,7 +945,7 @@ var StowServer = class {
   }
   searchSimilar(params) {
     const bucket = this.resolveBucket(params.bucket);
-    return this.request("/api/search/similar", {
+    return this.request("/search/similar", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({
@@ -964,7 +964,7 @@ var StowServer = class {
   }
   searchDiverse(params) {
     const bucket = this.resolveBucket(params.bucket);
-    return this.request("/api/search/diverse", {
+    return this.request("/search/diverse", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({
@@ -984,7 +984,7 @@ var StowServer = class {
   }
   searchText(params) {
     const bucket = this.resolveBucket(params.bucket);
-    return this.request("/api/search/text", {
+    return this.request("/search/text", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({
@@ -999,7 +999,7 @@ var StowServer = class {
   }
   searchColor(params) {
     const bucket = this.resolveBucket(params.bucket);
-    return this.request("/api/search/color", {
+    return this.request("/search/color", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({
@@ -1032,7 +1032,7 @@ var StowServer = class {
     const contentType = options?.contentType || "application/octet-stream";
     const filename = options?.filename || "file";
     const buffer = Buffer.isBuffer(file) ? file : Buffer.from(await file.arrayBuffer());
-    const presign = await this.request("/api/drops/presign", {
+    const presign = await this.request("/drops/presign", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({
@@ -1050,7 +1050,7 @@ var StowServer = class {
       throw new StowError("Failed to upload to storage", putRes.status);
     }
     return this.request(
-      presign.confirmUrl || "/api/drops/presign/confirm",
+      presign.confirmUrl || "/drops/presign/confirm",
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -1070,13 +1070,13 @@ var StowServer = class {
    * List all drops for the authenticated user
    */
   listDrops() {
-    return this.request("/api/drops", { method: "GET" }, listDropsSchema);
+    return this.request("/drops", { method: "GET" }, listDropsSchema);
   }
   /**
    * Delete a drop by ID
    */
   async deleteDrop(id) {
-    await this.request(`/api/drops/${encodeURIComponent(id)}`, {
+    await this.request(`/drops/${encodeURIComponent(id)}`, {
       method: "DELETE"
     });
   }
@@ -1089,89 +1089,80 @@ var StowServer = class {
   get profiles() {
     return {
       create: (params) => this.createProfile(params),
-      get: (id) => this.getProfile(id),
-      delete: (id) => this.deleteProfile(id),
+      get: (id, bucket) => this.getProfile(id, bucket),
+      delete: (id, bucket) => this.deleteProfile(id, bucket),
       addFiles: (id, fileKeys, bucket) => this.addProfileFiles(id, fileKeys, bucket),
       removeFiles: (id, fileKeys, bucket) => this.removeProfileFiles(id, fileKeys, bucket),
       signal: (id, signals, bucket) => this.signalProfile(id, signals, bucket),
-      deleteSignals: (id, signalIds) => this.deleteProfileSignals(id, signalIds),
-      clusters: (id) => this.getProfileClusters(id),
-      recluster: (id, params) => this.reclusterProfile(id, params),
-      renameCluster: (profileId, clusterId, params) => this.renameProfileCluster(profileId, clusterId, params)
+      deleteSignals: (id, signalIds, bucket) => this.deleteProfileSignals(id, signalIds, bucket),
+      clusters: (id, bucket) => this.getProfileClusters(id, bucket),
+      recluster: (id, params, bucket) => this.reclusterProfile(id, params, bucket),
+      renameCluster: (profileId, clusterId, params, bucket) => this.renameProfileCluster(profileId, clusterId, params, bucket)
     };
   }
   createProfile(params) {
     return this.request(
-      "/api/profiles",
+      this.withBucket("/profiles", params?.bucket),
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify({
           ...params?.name ? { name: params.name } : {},
-          ...params?.fileKeys ? { fileKeys: params.fileKeys } : {},
-          ...params?.bucket ? { bucket: params.bucket } : {}
+          ...params?.fileKeys ? { fileKeys: params.fileKeys } : {}
         })
       },
       profileResultSchema
     );
   }
-  getProfile(id) {
+  getProfile(id, bucket) {
     return this.request(
-      `/api/profiles/${encodeURIComponent(id)}`,
+      this.withBucket(`/profiles/${encodeURIComponent(id)}`, bucket),
       { method: "GET" },
       profileResultSchema
     );
   }
-  async deleteProfile(id) {
-    await this.request(`/api/profiles/${encodeURIComponent(id)}`, {
-      method: "DELETE"
-    });
+  async deleteProfile(id, bucket) {
+    await this.request(
+      this.withBucket(`/profiles/${encodeURIComponent(id)}`, bucket),
+      { method: "DELETE" }
+    );
   }
   addProfileFiles(id, fileKeys, bucket) {
     return this.request(
-      `/api/profiles/${encodeURIComponent(id)}/files`,
+      this.withBucket(`/profiles/${encodeURIComponent(id)}/files`, bucket),
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          fileKeys,
-          ...bucket ? { bucket } : {}
-        })
+        body: JSON.stringify({ fileKeys })
       },
       profileFilesResultSchema
     );
   }
   removeProfileFiles(id, fileKeys, bucket) {
     return this.request(
-      `/api/profiles/${encodeURIComponent(id)}/files`,
+      this.withBucket(`/profiles/${encodeURIComponent(id)}/files`, bucket),
       {
         method: "DELETE",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          fileKeys,
-          ...bucket ? { bucket } : {}
-        })
+        body: JSON.stringify({ fileKeys })
       },
       profileFilesResultSchema
     );
   }
   signalProfile(id, signals, bucket) {
     return this.request(
-      `/api/profiles/${encodeURIComponent(id)}/signals`,
+      this.withBucket(`/profiles/${encodeURIComponent(id)}/signals`, bucket),
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          signals,
-          ...bucket ? { bucket } : {}
-        })
+        body: JSON.stringify({ signals })
       },
       profileSignalsResponseSchema
     );
   }
-  deleteProfileSignals(id, signalIds) {
+  deleteProfileSignals(id, signalIds, bucket) {
     return this.request(
-      `/api/profiles/${encodeURIComponent(id)}/signals`,
+      this.withBucket(`/profiles/${encodeURIComponent(id)}/signals`, bucket),
       {
         method: "DELETE",
         headers: { "Content-Type": "application/json" },
@@ -1180,23 +1171,30 @@ var StowServer = class {
       deleteProfileSignalsResponseSchema
     );
   }
-  getProfileClusters(id) {
-    return this.request(`/api/profiles/${encodeURIComponent(id)}/clusters`, {
-      method: "GET"
-    });
+  getProfileClusters(id, bucket) {
+    return this.request(
+      this.withBucket(`/profiles/${encodeURIComponent(id)}/clusters`, bucket),
+      { method: "GET" }
+    );
   }
-  reclusterProfile(id, params) {
-    return this.request(`/api/profiles/${encodeURIComponent(id)}/clusters`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        ...params?.clusterCount !== void 0 ? { clusterCount: params.clusterCount } : {}
-      })
-    });
+  reclusterProfile(id, params, bucket) {
+    return this.request(
+      this.withBucket(`/profiles/${encodeURIComponent(id)}/clusters`, bucket),
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          ...params?.clusterCount !== void 0 ? { clusterCount: params.clusterCount } : {}
+        })
+      }
+    );
   }
-  renameProfileCluster(profileId, clusterId, params) {
+  renameProfileCluster(profileId, clusterId, params, bucket) {
     return this.request(
-      `/api/profiles/${encodeURIComponent(profileId)}/clusters/${encodeURIComponent(clusterId)}`,
+      this.withBucket(
+        `/profiles/${encodeURIComponent(profileId)}/clusters/${encodeURIComponent(clusterId)}`,
+        bucket
+      ),
       {
         method: "PUT",
         headers: { "Content-Type": "application/json" },

package/dist/index.mjs

@@ -269,12 +269,12 @@ var StowServer = class {
   constructor(config) {
     if (typeof config === "string") {
       this.apiKey = config;
-      this.baseUrl = "https://app.stow.sh";
+      this.baseUrl = "https://api.stow.sh";
       this.timeout = 3e4;
       this.retries = 3;
     } else {
       this.apiKey = config.apiKey;
-      this.baseUrl = config.baseUrl || "https://app.stow.sh";
+      this.baseUrl = config.baseUrl || "https://api.stow.sh";
       this.bucket = config.bucket;
       this.timeout = config.timeout ?? 3e4;
       this.retries = config.retries ?? 3;
@@ -290,20 +290,20 @@ var StowServer = class {
    * Return account usage and API key info for the current credential.
    */
   whoami() {
-    return this.request("/api/whoami", { method: "GET" }, whoamiSchema);
+    return this.request("/whoami", { method: "GET" }, whoamiSchema);
   }
   /**
    * List all buckets available to the current organization.
    */
   listBuckets() {
-    return this.request("/api/buckets", { method: "GET" }, listBucketsSchema);
+    return this.request("/buckets", { method: "GET" }, listBucketsSchema);
   }
   /**
    * Create a new bucket.
    */
   async createBucket(request) {
     const result = await this.request(
-      "/api/buckets",
+      "/buckets",
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -318,7 +318,7 @@ var StowServer = class {
    */
   async getBucket(id) {
     const result = await this.request(
-      `/api/buckets/${encodeURIComponent(id)}`,
+      `/buckets/${encodeURIComponent(id)}`,
       { method: "GET" },
       bucketResponseSchema
     );
@@ -329,7 +329,7 @@ var StowServer = class {
    */
   async updateBucket(id, updates) {
     const result = await this.request(
-      `/api/buckets/${encodeURIComponent(id)}`,
+      `/buckets/${encodeURIComponent(id)}`,
       {
         method: "PATCH",
         headers: { "Content-Type": "application/json" },
@@ -344,7 +344,7 @@ var StowServer = class {
    */
   async updateBucketByName(name, updates) {
     const result = await this.request(
-      `/api/buckets/_?bucket=${encodeURIComponent(name)}`,
+      `/buckets/_?bucket=${encodeURIComponent(name)}`,
       {
         method: "PATCH",
         headers: { "Content-Type": "application/json" },
@@ -364,7 +364,7 @@ var StowServer = class {
    * Delete a bucket by id.
    */
   async deleteBucket(id) {
-    await this.request(`/api/buckets/${encodeURIComponent(id)}`, {
+    await this.request(`/buckets/${encodeURIComponent(id)}`, {
       method: "DELETE"
     });
   }
@@ -492,7 +492,7 @@ var StowServer = class {
     }
     return this.request(
       this.withBucket(
-        presign.confirmUrl || "/api/presign/confirm",
+        presign.confirmUrl || "/presign/confirm",
         options?.bucket
       ),
       {
@@ -518,7 +518,7 @@ var StowServer = class {
    */
   async uploadFromUrl(url, filename, options) {
     const result = await this.request(
-      this.withBucket("/api/upload", options?.bucket),
+      this.withBucket("/upload", options?.bucket),
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -551,7 +551,7 @@ var StowServer = class {
    */
   async queueUploadFromUrl(url, filename, options) {
     return this.request(
-      this.withBucket("/api/upload", options?.bucket),
+      this.withBucket("/upload", options?.bucket),
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -589,7 +589,7 @@ var StowServer = class {
       contentHash
     } = request;
     return this.request(
-      this.withBucket("/api/presign", bucket),
+      this.withBucket("/presign", bucket),
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -623,7 +623,7 @@ var StowServer = class {
       altText
     } = request;
     return this.request(
-      this.withBucket("/api/presign/confirm", bucket),
+      this.withBucket("/presign/confirm", bucket),
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -664,7 +664,7 @@ var StowServer = class {
     if (options?.include?.length) {
       params.set("include", options.include.join(","));
     }
-    const path = `/api/files?${params}`;
+    const path = `/files?${params}`;
     return this.request(
       this.withBucket(path, options?.bucket),
       { method: "GET" },
@@ -675,7 +675,7 @@ var StowServer = class {
    * Delete a file by key
    */
   async deleteFile(key, options) {
-    const path = `/api/files/${encodeURIComponent(key)}`;
+    const path = `/files/${encodeURIComponent(key)}`;
     await this.request(this.withBucket(path, options?.bucket), {
       method: "DELETE"
     });
@@ -684,7 +684,7 @@ var StowServer = class {
    * Update metadata on an existing file
    */
   updateFileMetadata(key, metadata, options) {
-    const path = `/api/files/${encodeURIComponent(key)}`;
+    const path = `/files/${encodeURIComponent(key)}`;
     return this.request(this.withBucket(path, options?.bucket), {
       method: "PATCH",
       headers: { "Content-Type": "application/json" },
@@ -702,7 +702,7 @@ var StowServer = class {
       params.set("include", options.include.join(","));
     }
     const qs = params.toString();
-    const path = `/api/files/${encodeURIComponent(key)}${qs ? `?${qs}` : ""}`;
+    const path = `/files/${encodeURIComponent(key)}${qs ? `?${qs}` : ""}`;
     return this.request(
       this.withBucket(path, options?.bucket),
       { method: "GET" },
@@ -714,7 +714,7 @@ var StowServer = class {
    * Requires a searchable bucket.
    */
   extractColors(key, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/colors`;
+    const path = `/files/${encodeURIComponent(key)}/colors`;
     return this.request(
       this.withBucket(path, options?.bucket),
       { method: "POST" },
@@ -725,7 +725,7 @@ var StowServer = class {
    * Extract dimensions (width/height) from an image or video file.
    */
   extractDimensions(key, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/dimensions`;
+    const path = `/files/${encodeURIComponent(key)}/dimensions`;
     return this.request(
       this.withBucket(path, options?.bucket),
       { method: "POST" },
@@ -737,7 +737,7 @@ var StowServer = class {
    * Requires a searchable bucket.
    */
   embed(key, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/embedding`;
+    const path = `/files/${encodeURIComponent(key)}/embedding`;
     return this.request(
       this.withBucket(path, options?.bucket),
       { method: "POST" },
@@ -749,7 +749,7 @@ var StowServer = class {
    * Requires a searchable bucket.
    */
   generateTitle(key, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/title`;
+    const path = `/files/${encodeURIComponent(key)}/title`;
     return this.request(
       this.withBucket(path, options?.bucket),
       { method: "POST" },
@@ -761,7 +761,7 @@ var StowServer = class {
    * Requires a searchable bucket.
    */
   generateDescription(key, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/description`;
+    const path = `/files/${encodeURIComponent(key)}/description`;
     return this.request(
       this.withBucket(path, options?.bucket),
       { method: "POST" },
@@ -773,7 +773,7 @@ var StowServer = class {
    * Requires a searchable bucket.
    */
   generateAltText(key, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/alt-text`;
+    const path = `/files/${encodeURIComponent(key)}/alt-text`;
     return this.request(
       this.withBucket(path, options?.bucket),
       { method: "POST" },
@@ -788,7 +788,7 @@ var StowServer = class {
    * tasks are re-dispatched as if the file were newly uploaded.
    */
   replaceFile(key, url, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/replace`;
+    const path = `/files/${encodeURIComponent(key)}/replace`;
     return this.request(
       this.withBucket(path, options?.bucket),
       {
@@ -845,17 +845,17 @@ var StowServer = class {
     };
   }
   listTags() {
-    return this.request("/api/tags", { method: "GET" });
+    return this.request("/tags", { method: "GET" });
   }
   createTag(params) {
-    return this.request("/api/tags", {
+    return this.request("/tags", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify(params)
     });
   }
   async deleteTag(id) {
-    await this.request(`/api/tags/${encodeURIComponent(id)}`, {
+    await this.request(`/tags/${encodeURIComponent(id)}`, {
       method: "DELETE"
     });
   }
@@ -866,7 +866,7 @@ var StowServer = class {
    * Add tags to a file
    */
   async addTags(key, tagIds, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/tags`;
+    const path = `/files/${encodeURIComponent(key)}/tags`;
     await this.request(this.withBucket(path, options?.bucket), {
       method: "POST",
       headers: { "Content-Type": "application/json" },
@@ -877,7 +877,7 @@ var StowServer = class {
    * Remove a tag from a file
    */
   async removeTag(key, tagId, options) {
-    const path = `/api/files/${encodeURIComponent(key)}/tags/${encodeURIComponent(tagId)}`;
+    const path = `/files/${encodeURIComponent(key)}/tags/${encodeURIComponent(tagId)}`;
     await this.request(this.withBucket(path, options?.bucket), {
       method: "DELETE"
     });
@@ -902,7 +902,7 @@ var StowServer = class {
     };
   }
   listTaxonomies() {
-    return this.request("/api/taxonomies", { method: "GET" });
+    return this.request("/taxonomies", { method: "GET" });
   }
   // ============================================================
   // SEARCH - Vector similarity search
@@ -920,7 +920,7 @@ var StowServer = class {
   }
   searchSimilar(params) {
     const bucket = this.resolveBucket(params.bucket);
-    return this.request("/api/search/similar", {
+    return this.request("/search/similar", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({
@@ -939,7 +939,7 @@ var StowServer = class {
   }
   searchDiverse(params) {
     const bucket = this.resolveBucket(params.bucket);
-    return this.request("/api/search/diverse", {
+    return this.request("/search/diverse", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({
@@ -959,7 +959,7 @@ var StowServer = class {
   }
   searchText(params) {
     const bucket = this.resolveBucket(params.bucket);
-    return this.request("/api/search/text", {
+    return this.request("/search/text", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({
@@ -974,7 +974,7 @@ var StowServer = class {
   }
   searchColor(params) {
     const bucket = this.resolveBucket(params.bucket);
-    return this.request("/api/search/color", {
+    return this.request("/search/color", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({
@@ -1007,7 +1007,7 @@ var StowServer = class {
     const contentType = options?.contentType || "application/octet-stream";
     const filename = options?.filename || "file";
     const buffer = Buffer.isBuffer(file) ? file : Buffer.from(await file.arrayBuffer());
-    const presign = await this.request("/api/drops/presign", {
+    const presign = await this.request("/drops/presign", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({
@@ -1025,7 +1025,7 @@ var StowServer = class {
       throw new StowError("Failed to upload to storage", putRes.status);
     }
     return this.request(
-      presign.confirmUrl || "/api/drops/presign/confirm",
+      presign.confirmUrl || "/drops/presign/confirm",
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -1045,13 +1045,13 @@ var StowServer = class {
    * List all drops for the authenticated user
    */
   listDrops() {
-    return this.request("/api/drops", { method: "GET" }, listDropsSchema);
+    return this.request("/drops", { method: "GET" }, listDropsSchema);
   }
   /**
    * Delete a drop by ID
    */
   async deleteDrop(id) {
-    await this.request(`/api/drops/${encodeURIComponent(id)}`, {
+    await this.request(`/drops/${encodeURIComponent(id)}`, {
       method: "DELETE"
     });
   }
@@ -1064,89 +1064,80 @@ var StowServer = class {
   get profiles() {
     return {
       create: (params) => this.createProfile(params),
-      get: (id) => this.getProfile(id),
-      delete: (id) => this.deleteProfile(id),
+      get: (id, bucket) => this.getProfile(id, bucket),
+      delete: (id, bucket) => this.deleteProfile(id, bucket),
       addFiles: (id, fileKeys, bucket) => this.addProfileFiles(id, fileKeys, bucket),
       removeFiles: (id, fileKeys, bucket) => this.removeProfileFiles(id, fileKeys, bucket),
       signal: (id, signals, bucket) => this.signalProfile(id, signals, bucket),
-      deleteSignals: (id, signalIds) => this.deleteProfileSignals(id, signalIds),
-      clusters: (id) => this.getProfileClusters(id),
-      recluster: (id, params) => this.reclusterProfile(id, params),
-      renameCluster: (profileId, clusterId, params) => this.renameProfileCluster(profileId, clusterId, params)
+      deleteSignals: (id, signalIds, bucket) => this.deleteProfileSignals(id, signalIds, bucket),
+      clusters: (id, bucket) => this.getProfileClusters(id, bucket),
+      recluster: (id, params, bucket) => this.reclusterProfile(id, params, bucket),
+      renameCluster: (profileId, clusterId, params, bucket) => this.renameProfileCluster(profileId, clusterId, params, bucket)
     };
   }
   createProfile(params) {
     return this.request(
-      "/api/profiles",
+      this.withBucket("/profiles", params?.bucket),
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify({
           ...params?.name ? { name: params.name } : {},
-          ...params?.fileKeys ? { fileKeys: params.fileKeys } : {},
-          ...params?.bucket ? { bucket: params.bucket } : {}
+          ...params?.fileKeys ? { fileKeys: params.fileKeys } : {}
         })
       },
       profileResultSchema
     );
   }
-  getProfile(id) {
+  getProfile(id, bucket) {
     return this.request(
-      `/api/profiles/${encodeURIComponent(id)}`,
+      this.withBucket(`/profiles/${encodeURIComponent(id)}`, bucket),
       { method: "GET" },
       profileResultSchema
     );
   }
-  async deleteProfile(id) {
-    await this.request(`/api/profiles/${encodeURIComponent(id)}`, {
-      method: "DELETE"
-    });
+  async deleteProfile(id, bucket) {
+    await this.request(
+      this.withBucket(`/profiles/${encodeURIComponent(id)}`, bucket),
+      { method: "DELETE" }
+    );
   }
   addProfileFiles(id, fileKeys, bucket) {
     return this.request(
-      `/api/profiles/${encodeURIComponent(id)}/files`,
+      this.withBucket(`/profiles/${encodeURIComponent(id)}/files`, bucket),
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          fileKeys,
-          ...bucket ? { bucket } : {}
-        })
+        body: JSON.stringify({ fileKeys })
       },
       profileFilesResultSchema
     );
   }
   removeProfileFiles(id, fileKeys, bucket) {
     return this.request(
-      `/api/profiles/${encodeURIComponent(id)}/files`,
+      this.withBucket(`/profiles/${encodeURIComponent(id)}/files`, bucket),
       {
         method: "DELETE",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          fileKeys,
-          ...bucket ? { bucket } : {}
-        })
+        body: JSON.stringify({ fileKeys })
       },
       profileFilesResultSchema
     );
   }
   signalProfile(id, signals, bucket) {
     return this.request(
-      `/api/profiles/${encodeURIComponent(id)}/signals`,
+      this.withBucket(`/profiles/${encodeURIComponent(id)}/signals`, bucket),
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          signals,
-          ...bucket ? { bucket } : {}
-        })
+        body: JSON.stringify({ signals })
       },
       profileSignalsResponseSchema
     );
   }
-  deleteProfileSignals(id, signalIds) {
+  deleteProfileSignals(id, signalIds, bucket) {
     return this.request(
-      `/api/profiles/${encodeURIComponent(id)}/signals`,
+      this.withBucket(`/profiles/${encodeURIComponent(id)}/signals`, bucket),
       {
         method: "DELETE",
         headers: { "Content-Type": "application/json" },
@@ -1155,23 +1146,30 @@ var StowServer = class {
       deleteProfileSignalsResponseSchema
     );
   }
-  getProfileClusters(id) {
-    return this.request(`/api/profiles/${encodeURIComponent(id)}/clusters`, {
-      method: "GET"
-    });
+  getProfileClusters(id, bucket) {
+    return this.request(
+      this.withBucket(`/profiles/${encodeURIComponent(id)}/clusters`, bucket),
+      { method: "GET" }
+    );
   }
-  reclusterProfile(id, params) {
-    return this.request(`/api/profiles/${encodeURIComponent(id)}/clusters`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        ...params?.clusterCount !== void 0 ? { clusterCount: params.clusterCount } : {}
-      })
-    });
+  reclusterProfile(id, params, bucket) {
+    return this.request(
+      this.withBucket(`/profiles/${encodeURIComponent(id)}/clusters`, bucket),
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          ...params?.clusterCount !== void 0 ? { clusterCount: params.clusterCount } : {}
+        })
+      }
+    );
   }
-  renameProfileCluster(profileId, clusterId, params) {
+  renameProfileCluster(profileId, clusterId, params, bucket) {
     return this.request(
-      `/api/profiles/${encodeURIComponent(profileId)}/clusters/${encodeURIComponent(clusterId)}`,
+      this.withBucket(
+        `/profiles/${encodeURIComponent(profileId)}/clusters/${encodeURIComponent(clusterId)}`,
+        bucket
+      ),
       {
         method: "PUT",
         headers: { "Content-Type": "application/json" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@howells/stow-server",
-  "version": "0.7.0",
+  "version": "2.0.1",
   "description": "Server-side SDK for Stow file storage",
   "license": "MIT",
   "repository": {
@@ -29,21 +29,21 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
   "peerDependencies": {
     "zod": "^3.0.0 || ^4.0.0"
   },
   "devDependencies": {
-    "@stow/typescript-config": "workspace:*",
-    "@types/node": "^25.3.0",
+    "@types/node": "^25.5.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.18",
-    "zod": "^4.3.6"
+    "vitest": "^4.1.0",
+    "zod": "^4.3.6",
+    "@stow/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}