@howells/stow-server 2.0.0 → 2.0.1

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

@@ -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(
-      "/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(
-      `/profiles/${encodeURIComponent(id)}`,
+      this.withBucket(`/profiles/${encodeURIComponent(id)}`, bucket),
       { method: "GET" },
       profileResultSchema
     );
   }
-  async deleteProfile(id) {
-    await this.request(`/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(
-      `/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(
-      `/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(
-      `/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(
-      `/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(`/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(`/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(
-      `/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

@@ -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(
-      "/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(
-      `/profiles/${encodeURIComponent(id)}`,
+      this.withBucket(`/profiles/${encodeURIComponent(id)}`, bucket),
       { method: "GET" },
       profileResultSchema
     );
   }
-  async deleteProfile(id) {
-    await this.request(`/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(
-      `/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(
-      `/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(
-      `/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(
-      `/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(`/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(`/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(
-      `/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": "2.0.0",
+  "version": "2.0.1",
   "description": "Server-side SDK for Stow file storage",
   "license": "MIT",
   "repository": {
@@ -33,10 +33,10 @@
     "zod": "^3.0.0 || ^4.0.0"
   },
   "devDependencies": {
-    "@types/node": "^25.3.0",
+    "@types/node": "^25.5.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.18",
+    "vitest": "^4.1.0",
     "zod": "^4.3.6",
     "@stow/typescript-config": "0.0.0"
   },