@howells/stow-server 2.2.0 → 2.3.0

package/README.md

@@ -67,10 +67,7 @@ const result = await stow.uploadFile(buffer, {
 Upload a file from a URL (server-side fetch + upload).
 
 ```typescript
-const result = await stow.uploadFromUrl(
-  "https://example.com/image.jpg",
-  "downloaded-image.jpg"
-);
+const result = await stow.uploadFromUrl("https://example.com/image.jpg", "downloaded-image.jpg");
 ```
 
 ### `getPresignedUrl(filename, contentType, route?)`
@@ -81,7 +78,7 @@ Get a presigned URL for client-side upload.
 const { uploadUrl, fileKey, fileUrl } = await stow.getPresignedUrl(
   "photo.jpg",
   "image/jpeg",
-  "avatars"
+  "avatars",
 );
 
 // Client can now PUT directly to uploadUrl
@@ -122,6 +119,7 @@ const transformedUrl = stow.getTransformUrl("https://photos.stow.sh/image.jpg",
 ```
 
 Transform options:
+
 - `width` — Max width in pixels (clamped to 4096)
 - `height` — Max height in pixels (clamped to 4096)
 - `quality` — 1–100, quantized to nearest 5 (default: 80)

package/dist/index.d.mts

@@ -1,3 +1,10 @@
+/** Error thrown when the Stow API returns a non-success response. */
+declare class StowError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    constructor(message: string, status: number, code?: string);
+}
+
 /**
  * Stow Server SDK
  *
@@ -21,12 +28,6 @@
  * console.log(result.url);
  * ```
  */
-/** Error thrown when the Stow API returns a non-success response. */
-declare class StowError extends Error {
-    readonly status: number;
-    readonly code?: string;
-    constructor(message: string, status: number, code?: string);
-}
 /** Configuration for creating a {@link StowServer} instance. */
 interface StowServerConfig {
     apiKey: string;
@@ -257,10 +258,21 @@ interface FileResult {
     url: string | null;
     width: number | null;
 }
-/** Input for creating a taste profile. */
+/**
+ * Input for creating a taste profile.
+ *
+ * Profiles are the right abstraction when you want a reusable preference vector
+ * that can evolve over time through file membership and weighted interaction
+ * signals such as `like`, `save`, or `purchase`.
+ *
+ * Use {@link ClusterCreateRequest} instead when you want to group a fixed,
+ * curated subset of files without behavioral weighting.
+ */
 interface ProfileCreateRequest {
     bucket?: string;
+    /** Initial files to seed into the profile before any interaction signals exist. */
     fileKeys?: string[];
+    /** Optional display name for dashboards, logs, or search integrations. */
     name?: string;
 }
 /** Cluster summary within a taste profile. */
@@ -275,13 +287,13 @@ interface ProfileClusterResult {
      * Optional taxonomy terms inferred for the cluster centroid.
      * Absent when taxonomy data is unavailable for the bucket/profile.
      */
-    tags?: Array<{
+    tags?: {
         group: string;
         groupSlug: string;
         similarity: number;
         tag: string;
         tagSlug: string;
-    }>;
+    }[];
     totalWeight: number;
 }
 /** Taste profile detail payload. */
@@ -295,8 +307,118 @@ interface ProfileResult {
     updatedAt: string;
     vector: number[] | null;
 }
-/** Input for recomputing profile clusters. */
+/**
+ * Input for creating a curated clustering resource from an explicit file set.
+ *
+ * This resource is designed for cases like "cluster these 200 featured images
+ * into 12 visual groups" where every listed file should be treated equally.
+ * No behavioral signals or master preference vector are involved.
+ *
+ * The API returns immediately with the persisted resource. Clustering and
+ * cluster naming complete asynchronously, so call `stow.clusters.get(id)` to
+ * observe progress.
+ *
+ * @example
+ * ```typescript
+ * const resource = await stow.clusters.create({
+ *   bucket: "inspiration",
+ *   name: "Spring navigator",
+ *   fileKeys: featuredKeys,
+ *   clusterCount: 12,
+ * });
+ * ```
+ */
+interface ClusterCreateRequest {
+    /** Bucket name or ID. Optional when the {@link StowServer} instance already has a default bucket. */
+    bucket?: string;
+    /**
+     * Number of K-means clusters to produce.
+     *
+     * When omitted, the API auto-selects a value using
+     * `max(3, min(15, round(sqrt(fileCount / 10))))`.
+     */
+    clusterCount?: number;
+    /** Exact file keys to cluster. Files without embeddings cannot participate. */
+    fileKeys: string[];
+    /** Optional human-friendly resource name. */
+    name?: string;
+}
+/**
+ * One group within a curated clustering resource.
+ *
+ * Group names and descriptions are generated asynchronously. Immediately after
+ * creation or reclustering, `name` and `description` may be `null` until the
+ * naming worker completes or a human renames the cluster manually.
+ */
+interface ClusterGroupResult {
+    description: string | null;
+    /** Number of files currently assigned to this group. */
+    fileCount: number;
+    id: string;
+    /** Zero-based index produced by the clustering run. */
+    index: number;
+    name: string | null;
+    /** Timestamp for the most recent generated or manual naming pass. */
+    nameGeneratedAt: string | null;
+}
+/**
+ * Persisted curated clustering resource.
+ *
+ * `clusterCount` is the requested or auto-selected target. `clusters.length`
+ * represents the current persisted groups for the latest clustering run.
+ * `clusteredAt` stays `null` until the worker has written assignments.
+ */
+interface ClusterResourceResult {
+    clusterCount: number;
+    /** Timestamp of the last completed clustering pass. Null while work is still pending. */
+    clusteredAt: string | null;
+    clusters: ClusterGroupResult[];
+    createdAt: string;
+    /** Number of source files included in the resource. */
+    fileCount: number;
+    id: string;
+    name: string | null;
+    updatedAt: string;
+}
+/**
+ * One file assigned to a curated cluster group.
+ *
+ * When returned from `stow.clusters.files(...)`, items are ordered by ascending
+ * distance to the group centroid so the first files are usually the best
+ * representatives for labeling, previews, or inspiration navigators.
+ */
+interface ClusterFileResult {
+    bucketId: string;
+    contentType: string;
+    createdAt: string;
+    /** Euclidean distance from the cluster centroid. Lower means more representative. */
+    distance: number | null;
+    id: string;
+    key: string;
+    metadata: Record<string, string> | null;
+    originalFilename: string | null;
+    size: number;
+}
+/**
+ * Paginated files assigned to one curated cluster group.
+ *
+ * Results are stable within a clustering run and ordered by distance to the
+ * centroid, making page 1 suitable for "representative examples".
+ */
+interface ClusterFilesResult {
+    clusterId: string;
+    files: ClusterFileResult[];
+    limit: number;
+    offset: number;
+    total: number;
+}
+/**
+ * Input for recomputing clusters.
+ *
+ * Used by both `profiles.recluster(...)` and `clusters.recluster(...)`.
+ */
 interface ReclusterRequest {
+    /** Override the existing cluster count for the next clustering pass. */
     clusterCount?: number;
 }
 /** Result payload from cluster recomputation. */
@@ -306,7 +428,12 @@ interface ReclusterResult {
     profileId: string;
     totalSignals: number;
 }
-/** Input for updating cluster display metadata. */
+/**
+ * Input for manually naming a cluster.
+ *
+ * This is intended for the final editorial pass after generated names are
+ * available. You can send just `name`, just `description`, or both.
+ */
 interface RenameClusterRequest {
     description?: string;
     name?: string;
@@ -451,15 +578,39 @@ interface ConfirmUploadRequest {
     /** Request AI-generated title for images */
     title?: boolean;
 }
-/** Input payload for similarity search. */
+/**
+ * Input payload for similarity search.
+ *
+ * Provide exactly one semantic seed:
+ * - `fileKey`
+ * - `anchorId`
+ * - `profileId`
+ * - `clusterId`
+ * - `clusterIds`
+ * - `vector`
+ *
+ * Cluster seeds follow the same shape as profile clustering:
+ * - with `profileId`, `clusterId` or `clusterIds` reference profile clusters
+ * - without `profileId`, they reference curated clusters created via `/clusters`
+ */
 interface SimilarSearchRequest {
     /** Use an anchor's embedding as the query vector */
     anchorId?: string;
     /** Bucket name or ID to scope search */
     bucket?: string;
-    /** Use a specific cluster centroid instead of the profile master vector. Requires profileId. */
+    /**
+     * Use a specific cluster centroid as the query vector.
+     *
+     * With `profileId`, this resolves a profile cluster. Without `profileId`, it
+     * resolves a curated cluster group from `stow.clusters`.
+     */
     clusterId?: string;
-    /** Blend multiple cluster centroids as query vector. Requires profileId. */
+    /**
+     * Blend multiple cluster centroids into one query vector.
+     *
+     * With `profileId`, these resolve profile clusters. Without `profileId`, they
+     * resolve curated cluster groups from `stow.clusters`.
+     */
     clusterIds?: string[];
     /** File keys to exclude from results (e.g. already-seen items). Max 500. */
     excludeKeys?: string[];
@@ -471,20 +622,35 @@ interface SimilarSearchRequest {
     include?: SearchIncludeField[];
     /** Max results (default 10, max 50) */
     limit?: number;
-    /** Search using a taste profile's vector */
+    /** Search using a taste profile's master vector. */
     profileId?: string;
     /** Search directly with a vector (1024 dimensions) */
     vector?: number[];
 }
-/** Input payload for diversity-aware search. */
+/**
+ * Input payload for diversity-aware search.
+ *
+ * This uses the same seed rules as {@link SimilarSearchRequest} but balances
+ * relevance against diversity using `lambda`.
+ */
 interface DiverseSearchRequest {
     /** Use an anchor's embedding as the query vector */
     anchorId?: string;
     /** Bucket name or ID to scope search */
     bucket?: string;
-    /** Use a specific cluster centroid instead of the profile master vector. Requires profileId. */
+    /**
+     * Use a specific cluster centroid as the seed vector.
+     *
+     * With `profileId`, this resolves a profile cluster. Without `profileId`, it
+     * resolves a curated cluster group from `stow.clusters`.
+     */
     clusterId?: string;
-    /** Blend multiple cluster centroids as query vector. Requires profileId. */
+    /**
+     * Blend multiple cluster centroids into one seed vector.
+     *
+     * With `profileId`, these resolve profile clusters. Without `profileId`, they
+     * resolve curated cluster groups from `stow.clusters`.
+     */
     clusterIds?: string[];
     /** File keys to exclude from results (e.g. already-seen items). Max 500. */
     excludeKeys?: string[];
@@ -519,18 +685,18 @@ interface SearchResultItem {
     originalFilename: string | null;
     similarity: number;
     size: number;
-    tags?: Array<{
+    tags?: {
         slug: string;
         name: string;
-    }>;
-    taxonomies?: Array<{
+    }[];
+    taxonomies?: {
         externalUri: string | null;
         group: string;
         name: string;
         similarity: number;
         slug: string;
         source: string;
-    }>;
+    }[];
     width?: number | null;
 }
 /** A text anchor — a named semantic reference point in a bucket's vector space. */
@@ -683,17 +849,57 @@ interface TaxonomyGroup {
 interface TaxonomyListResult {
     groups: TaxonomyGroup[];
 }
-/** Server-side SDK client for Stow's API. */
+/**
+ * Server-side SDK client for Stow's HTTP API.
+ *
+ * Use this package from trusted environments only: Next.js route handlers,
+ * server actions, workers, backend services, CLIs, or scripts. It owns API-key
+ * auth and exposes the full bucket/file/search/profile/cluster surface.
+ *
+ * Bucket scoping rules:
+ * - pass `bucket` to the constructor to set a default for the instance
+ * - pass `bucket` to a method to override that default for one call
+ * - omit both only when the API key itself is bucket-scoped
+ *
+ * @example
+ * ```typescript
+ * const stow = new StowServer({
+ *   apiKey: process.env.STOW_API_KEY!,
+ *   bucket: "brand-assets",
+ * });
+ *
+ * const upload = await stow.uploadFile(buffer, {
+ *   filename: "hero.jpg",
+ *   contentType: "image/jpeg",
+ *   title: true,
+ *   altText: true,
+ * });
+ *
+ * const { results } = await stow.search.similar({ fileKey: upload.key, limit: 8 });
+ * ```
+ */
 declare class StowServer {
     private readonly apiKey;
     private readonly baseUrl;
     private readonly bucket?;
     private readonly timeout;
     private readonly retries;
-    constructor(config: StowServerConfig | string);
     /**
-     * Get the base URL for this instance (used by client SDK)
+     * Pure helper for building signed transform URLs from an existing public file URL.
+     *
+     * This does not perform any network I/O and is safe to pass around as a plain
+     * function, for example to view-layer code that needs responsive image URLs.
+     */
+    readonly getTransformUrl: (url: string, options?: TransformOptions) => string;
+    /**
+     * Create a server SDK instance.
+     *
+     * Pass a bare string when you only need the API key and want default values
+     * for `baseUrl`, `timeout`, and retries. Pass an object when you want a
+     * default bucket, a non-production API origin, or custom transport settings.
      */
+    constructor(config: StowServerConfig | string);
+    /** Return the configured API origin, mainly for adapter packages such as `stow-next`. */
     getBaseUrl(): string;
     /**
      * Return account usage and API key info for the current credential.
@@ -744,9 +950,30 @@ declare class StowServer {
      * - Consumer can pass `signal` in options to cancel.
      */
     private request;
-    private sleep;
     /**
-     * Upload a file directly from the server
+     * Upload bytes from a trusted server environment.
+     *
+     * This is the highest-level server upload helper:
+     * 1. compute a SHA-256 hash for dedupe
+     * 2. request a presigned upload URL
+     * 3. PUT bytes to storage
+     * 4. confirm the upload with optional AI metadata generation
+     *
+     * Prefer this method when your code already has the file bytes in memory.
+     * Use `getPresignedUrl()` + `confirmUpload()` for direct browser uploads
+     * instead, and `uploadFromUrl()` when the source is an external URL.
+     *
+     * @example
+     * ```typescript
+     * await stow.uploadFile(buffer, {
+     *   filename: "product.jpg",
+     *   contentType: "image/jpeg",
+     *   bucket: "catalog",
+     *   metadata: { sku: "SKU-123" },
+     *   title: true,
+     *   altText: true,
+     * });
+     * ```
      */
     uploadFile(file: Buffer | Blob, options?: {
         filename?: string;
@@ -764,7 +991,12 @@ declare class StowServer {
         altText?: boolean;
     }): Promise<UploadResult>;
     /**
-     * Upload a file from a URL (server-side fetch + upload)
+     * Import a remote asset by URL.
+     *
+     * Stow fetches the remote URL server-side, stores the resulting bytes, and
+     * persists the file as if it had been uploaded normally. This is useful for
+     * migrations, ingestion pipelines, or bringing third-party assets into Stow
+     * without downloading them into your own process first.
      */
     uploadFromUrl(url: string, filename: string, options?: {
         bucket?: string;
@@ -798,24 +1030,36 @@ declare class StowServer {
         altText?: boolean;
     }): Promise<QueuedResult>;
     /**
-     * Get a presigned URL for direct client-side upload.
+     * Get a presigned URL for a direct client upload.
      *
-     * This enables uploads that bypass your server entirely:
-     * 1. Client calls your endpoint
-     * 2. Your endpoint calls this method
-     * 3. Client PUTs directly to the returned uploadUrl
-     * 4. Client calls confirmUpload to finalize
+     * This is the server-side half of the browser upload flow used by
+     * `@howells/stow-client` and `@howells/stow-next`:
+     * 1. browser calls your app
+     * 2. your app calls `getPresignedUrl()`
+     * 3. browser PUTs bytes to `uploadUrl`
+     * 4. browser or your app calls `confirmUpload()`
+     *
+     * If `contentHash` matches an existing file in the target bucket, the API
+     * short-circuits with `{ dedupe: true, ... }` and no upload is required.
      */
     getPresignedUrl(request: PresignRequest): Promise<PresignResult>;
     /**
-     * Confirm a presigned upload after the client has uploaded to R2.
-     * This creates the file record in the database.
+     * Confirm a direct upload after the client has finished the storage PUT.
+     *
+     * This finalizes the file record in the database and optionally triggers
+     * post-processing such as AI-generated title/description/alt text.
+     *
+     * Call this exactly once per successful presigned upload.
      */
     confirmUpload(request: ConfirmUploadRequest): Promise<UploadResult>;
     /**
-     * List files in the bucket
+     * List files in a bucket with optional prefix filtering and enrichment blocks.
+     *
+     * Use `cursor` to continue pagination from a previous page. When requesting
+     * `include`, Stow expands those relationships inline so you can avoid follow-up
+     * per-file lookups.
      *
-     * @param options.include - Optional enrichment fields: `"tags"`, `"taxonomies"`
+     * @param options.include Optional enrichment fields: `"tags"`, `"taxonomies"`
      */
     listFiles(options?: {
         prefix?: string;
@@ -843,9 +1087,12 @@ declare class StowServer {
         metadata: Record<string, string>;
     }>;
     /**
-     * Get a single file by key
+     * Get one file by key.
+     *
+     * This is the detailed file view and includes dimensions, embeddings status,
+     * extracted colors, and AI metadata fields when available.
      *
-     * @param options.include - Optional enrichment fields: `"tags"`, `"taxonomies"`
+     * @param options.include Optional enrichment fields: `"tags"`, `"taxonomies"`
      */
     getFile(key: string, options?: {
         bucket?: string;
@@ -904,29 +1151,18 @@ declare class StowServer {
         /** Headers to forward when fetching the URL (e.g. User-Agent, Referer) */
         headers?: Record<string, string>;
     }): Promise<ReplaceResult>;
-    /**
-     * Get a transform URL for an image.
-     *
-     * Appends transform query params (?w=, ?h=, ?q=, ?f=) to a file URL.
-     * Transforms are applied at the edge by the Cloudflare Worker — no
-     * server round-trip needed.
-     *
-     * @param url - Full file URL (e.g. from upload result's fileUrl)
-     * @param options - Transform options (width, height, quality, format)
-     */
-    getTransformUrl(url: string, options?: TransformOptions): string;
     /**
      * Tags namespace for creating, listing, and deleting tags
      */
     get tags(): {
         list: () => Promise<{
-            tags: Array<{
+            tags: {
                 id: string;
                 name: string;
                 slug: string;
                 color: string | null;
                 createdAt: string;
-            }>;
+            }[];
         }>;
         create: (params: {
             name: string;
@@ -971,7 +1207,34 @@ declare class StowServer {
     };
     private listTaxonomies;
     /**
-     * Search namespace for vector similarity search
+     * Semantic search namespace.
+     *
+     * Methods:
+     * - `text(...)` embeds text and finds matching files
+     * - `similar(...)` finds nearest neighbors for a file, anchor, profile, or cluster
+     * - `diverse(...)` balances similarity against result spread
+     * - `color(...)` performs palette similarity search
+     * - `image(...)` searches using an existing file or an external image URL
+     *
+     * Cluster-aware search examples:
+     *
+     * @example
+     * ```typescript
+     * const cluster = await stow.clusters.create({
+     *   bucket: "inspiration",
+     *   fileKeys,
+     *   clusterCount: 12,
+     * });
+     *
+     * const firstGroup = cluster.clusters[0];
+     * if (firstGroup) {
+     *   const related = await stow.search.similar({
+     *     bucket: "inspiration",
+     *     clusterId: firstGroup.id,
+     *     limit: 20,
+     *   });
+     * }
+     * ```
      */
     get search(): {
         similar: (params: SimilarSearchRequest) => Promise<SimilarSearchResult>;
@@ -1010,7 +1273,11 @@ declare class StowServer {
      */
     deleteDrop(id: string): Promise<void>;
     /**
-     * Profiles namespace for managing taste profiles
+     * Taste-profile namespace.
+     *
+     * Profiles are long-lived preference objects. They can be seeded from files,
+     * updated through weighted signals, clustered into interpretable segments, and
+     * then reused as semantic search seeds.
      */
     get profiles(): {
         create: (params?: ProfileCreateRequest) => Promise<ProfileResult>;
@@ -1028,6 +1295,50 @@ declare class StowServer {
         recluster: (id: string, params?: ReclusterRequest, bucket?: string) => Promise<ReclusterResult>;
         renameCluster: (profileId: string, clusterId: string, params: RenameClusterRequest, bucket?: string) => Promise<ProfileClusterResult>;
     };
+    /**
+     * Curated cluster namespace.
+     *
+     * Use this when you have an explicit file set that should be grouped by visual
+     * similarity, but should not be modeled as a behavioral profile.
+     *
+     * Typical workflow:
+     * 1. `create({ fileKeys, clusterCount })`
+     * 2. poll `get(id)` until `clusteredAt` is non-null
+     * 3. inspect `clusters`
+     * 4. fetch representative files with `files(id, clusterId)`
+     * 5. optionally `renameCluster(...)`
+     * 6. use `clusterId` with `search.similar(...)` or `search.diverse(...)`
+     *
+     * @example
+     * ```typescript
+     * const resource = await stow.clusters.create({
+     *   bucket: "featured-products",
+     *   fileKeys: featuredKeys,
+     *   clusterCount: 12,
+     *   name: "Navigator groups",
+     * });
+     *
+     * const latest = await stow.clusters.get(resource.id, "featured-products");
+     * const group = latest.clusters[0];
+     * if (group) {
+     *   const representatives = await stow.clusters.files(resource.id, group.id, {
+     *     limit: 12,
+     *     offset: 0,
+     *   });
+     * }
+     * ```
+     */
+    get clusters(): {
+        create: (params: ClusterCreateRequest) => Promise<ClusterResourceResult>;
+        get: (id: string, bucket?: string) => Promise<ClusterResourceResult>;
+        recluster: (id: string, params?: ReclusterRequest, bucket?: string) => Promise<ClusterResourceResult>;
+        files: (id: string, clusterId: string, params?: {
+            limit?: number;
+            offset?: number;
+        }, bucket?: string) => Promise<ClusterFilesResult>;
+        renameCluster: (id: string, clusterId: string, params: RenameClusterRequest, bucket?: string) => Promise<ClusterGroupResult>;
+        delete: (id: string, bucket?: string) => Promise<void>;
+    };
     private createProfile;
     private getProfile;
     private deleteProfile;
@@ -1038,6 +1349,12 @@ declare class StowServer {
     private getProfileClusters;
     private reclusterProfile;
     private renameProfileCluster;
+    private createClustersResource;
+    private getClustersResource;
+    private reclusterClustersResource;
+    private getClusterFiles;
+    private renameClusterGroup;
+    private deleteClustersResource;
     /**
      * Anchors namespace for creating, listing, updating, and deleting text anchors.
      *
@@ -1069,4 +1386,4 @@ declare class StowServer {
     private deleteAnchor;
 }
 
-export { type Anchor, type AnchorSearchResult, type AppliedFilters, type BucketResult, type ColorSearchRequest, type ColorSearchResult, type ColorSearchResultItem, type ConfirmUploadRequest, type CreateAnchorRequest, type CreateBucketRequest, type DeleteProfileSignalsResult, type DiverseSearchRequest, type Drop, type DropResult, type FileColor, type FileColorProfile, type FileIncludeField, type FileResult, type FileTag, type FileTaxonomy, type FilteredMetadata, type ListBucketsResult, type ListDropsResult, type ListFilesItem, type ListFilesResult, type PresignDedupeResult, type PresignNewResult, type PresignRequest, type PresignResult, type ProfileClusterResult, type ProfileCreateRequest, type ProfileFilesResult, type ProfileResult, type ProfileSignalInput, type ProfileSignalResult, type ProfileSignalType, type ProfileSignalsResponse, type QueuedResult, type ReclusterRequest, type ReclusterResult, type RenameClusterRequest, type ReplaceResult, type SearchByImageInput, type SearchByImageOptions, type SearchByImageResult, type SearchByImageSource, type SearchFilters, type SearchIncludeField, type SearchResultItem, type SimilarSearchRequest, type SimilarSearchResult, StowError, StowServer, type StowServerConfig, type TaskTriggerResult, type TaxonomyGroup, type TaxonomyListResult, type TaxonomyTerm, type TextSearchRequest, type TransformOptions, type UpdateAnchorRequest, type UpdateBucketRequest, type UploadResult, type WhoamiResult };
+export { type Anchor, type AnchorSearchResult, type AppliedFilters, type BucketResult, type ClusterCreateRequest, type ClusterFileResult, type ClusterFilesResult, type ClusterGroupResult, type ClusterResourceResult, type ColorSearchRequest, type ColorSearchResult, type ColorSearchResultItem, type ConfirmUploadRequest, type CreateAnchorRequest, type CreateBucketRequest, type DeleteProfileSignalsResult, type DiverseSearchRequest, type Drop, type DropResult, type FileColor, type FileColorProfile, type FileIncludeField, type FileResult, type FileTag, type FileTaxonomy, type FilteredMetadata, type ListBucketsResult, type ListDropsResult, type ListFilesItem, type ListFilesResult, type PresignDedupeResult, type PresignNewResult, type PresignRequest, type PresignResult, type ProfileClusterResult, type ProfileCreateRequest, type ProfileFilesResult, type ProfileResult, type ProfileSignalInput, type ProfileSignalResult, type ProfileSignalType, type ProfileSignalsResponse, type QueuedResult, type ReclusterRequest, type ReclusterResult, type RenameClusterRequest, type ReplaceResult, type SearchByImageInput, type SearchByImageOptions, type SearchByImageResult, type SearchByImageSource, type SearchFilters, type SearchIncludeField, type SearchResultItem, type SimilarSearchRequest, type SimilarSearchResult, StowError, StowServer, type StowServerConfig, type TaskTriggerResult, type TaxonomyGroup, type TaxonomyListResult, type TaxonomyTerm, type TextSearchRequest, type TransformOptions, type UpdateAnchorRequest, type UpdateBucketRequest, type UploadResult, type WhoamiResult };