@thetechfossil/upfiles 1.0.12 → 1.0.13

package/README.md

@@ -110,7 +110,7 @@ export default function Page() {
       // clientOptions={{
       //   baseUrl: 'https://YOUR_APP_HOST',
       //   // or presignUrl: 'https://YOUR_APP_HOST/api/plugin/upload/presigned-url',
-      //   apiKey: process.env.NEXT_PUBLIC_UPFILES_API_KEY!,
+      //   apiKey: process.env.UPFILES_API_KEY!,
       //   apiKeyHeader: 'authorization', // or 'x-api-key' | 'x-up-api-key'
       // }}
     />
@@ -130,7 +130,7 @@ const client = new UpfilesClient({
   // presignPath: '/api/plugin/upload/presigned-url', // default
   // withCredentials: true, // for session routes (not typical for Plugin API)
   // Provide API key for Plugin API auth:
-  // apiKey: 'upk_...'
+  // apiKey: 'upf_...'
   // apiKeyHeader: 'authorization' // or 'x-api-key' | 'x-up-api-key'
 });
 
@@ -154,8 +154,8 @@ async function upload(file) {
   - `baseUrl` (optional): API base origin. Used with `presignPath`.
   - `presignPath` (optional): relative path, default `/api/plugin/upload/presigned-url`.
   - `headers` (optional): extra headers to send.
-  - `apiKey` (optional): API key value (e.g., `upk_...`).
-  - `apiKeyHeader` (optional): one of `'authorization' | 'x-api-key' | 'x-up-api-key'` (default `'authorization'`). If `'authorization'`, `Bearer` prefix is auto-added for `upk_...`.
+  - `apiKey` (optional): API key value (e.g., `upf_...`).
+  - `apiKeyHeader` (optional): one of `'authorization' | 'x-api-key' | 'x-up-api-key'` (default `'authorization'`). If `'authorization'`, `Bearer` prefix is auto-added for `upf_...`.
   - `withCredentials` (optional): `true` to send cookies.
   - Defaults: same-origin requests to `/api/plugin/upload/presigned-url`.
 - `client.getPresignedUrl({ fileName, fileType, fileSize, projectId?, folderPath? })`
@@ -195,7 +195,7 @@ import { UpfilesClient } from '@thetechfossil/upfiles';
 
 const client = new UpfilesClient({
   baseUrl: 'https://YOUR_APP_HOST',
-  apiKey: 'upk_...',
+  apiKey: 'upf_...',
   thumbnailsPath: '/api/plugin/thumbnails', // used to derive /api/plugin/files
 });
 
@@ -215,7 +215,7 @@ export default function PickFile() {
     <ProjectFilesWidget
       clientOptions={{
         baseUrl: 'https://YOUR_APP_HOST',
-        apiKey: process.env.NEXT_PUBLIC_UPFILES_API_KEY!,
+        apiKey: process.env.UPFILES_API_KEY!,
         apiKeyHeader: 'authorization',
         thumbnailsPath: '/api/plugin/thumbnails',
       }}
@@ -366,7 +366,7 @@ const { apiKey, projectId } = await createProject({ baseUrl, name: 'My App' });
 const key2 = await connectProject({ baseUrl, projectId: 'proj_123' });
 
 // 4) Manual
-const manual = addApiKeyManually('upk_...');
+const manual = addApiKeyManually('upf_...');
 
 // 5) Build an upload client with the key
 const client = createClientWithKey(baseUrl, apiKey);
@@ -425,7 +425,7 @@ export default function PickImage() {
         mode="browse"
         clientOptions={{
           baseUrl: process.env.NEXT_PUBLIC_UPFILES_APP_URL!,
-          apiKey: process.env.NEXT_PUBLIC_UPFILES_API_KEY!,
+          apiKey: process.env.UPFILES_API_KEY!,
           apiKeyHeader: 'authorization',
         }}
         // folderPath="my-plugin/images/" // optional
@@ -454,4 +454,4 @@ export default function PickImage() {
 - __401 Unauthorized when listing/creating projects__: The `projects` and `keys` endpoints require a signed-in session on the main app domain. Open the dialog from a page that can send cookies to `{baseUrl}` or run from the same origin; otherwise configure auth/CORS accordingly.
 - __CORS errors calling main app__: Ensure the main app allows your consumer origin in CORS and, if you use cookies, sets the correct `Access-Control-Allow-Credentials` headers and SameSite attributes.
 - __Uploads fail__: Verify S3 bucket CORS and that `POST /api/plugin/upload/presigned-url` is accessible from the consumer app.
-- __API key header__: Default is `Authorization: Bearer upk_...`. If your server expects a different header, set `apiKeyHeader: 'x-api-key' | 'x-up-api-key'` in `UpfilesClient` options.
+- __API key header__: Default is `Authorization: Bearer upf_...`. If your server expects a different header, set `apiKeyHeader: 'x-api-key' | 'x-up-api-key'` in `UpfilesClient` options.

package/dist/index.d.mts

@@ -1,6 +1,25 @@
-import React from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import React__default from 'react';
 
+type QuotaInfo = {
+    limitBytes: number;
+    usedBytes: number;
+    remainingBytes: number;
+};
+declare class StorageQuotaError extends Error {
+    details?: {
+        limit: number;
+        used: number;
+        remaining: number;
+        fileSize: number;
+    };
+    constructor(message: string, details?: {
+        limit: number;
+        used: number;
+        remaining: number;
+        fileSize: number;
+    });
+}
 type PresignResponse = {
     presignedUrl: string;
     fileKey: string;
@@ -51,7 +70,7 @@ type FileListItem = {
  * ```ts
  * const client = new UpfilesClient({
  *   baseUrl: 'https://your-upfiles.example.com',
- *   apiKey: 'upk_...',
+ *   apiKey: 'upf_...',
  * });
  * ```
  */
@@ -67,6 +86,12 @@ type UpfilesClientOptions = {
     completionPath?: string;
     foldersPath?: string;
     callCompletionEndpoint?: boolean;
+    /** Dynamic token getter for JWT-based auth (inhouse mode). Called on each request for fresh token. Takes priority over apiKey. */
+    getToken?: () => string | null | undefined | Promise<string | null | undefined>;
+    /** Project ID sent as x-project-id header when using getToken (JWT auth) */
+    projectId?: string;
+    /** Project name sent as x-project-name in in-house mode so the browser does not need the project id. */
+    projectName?: string;
 };
 /**
  * UpfilesClient - Main client class for interacting with Upfiles Plugin API
@@ -77,7 +102,7 @@ type UpfilesClientOptions = {
  * ```ts
  * const client = new UpfilesClient({
  *   baseUrl: 'https://your-upfiles.example.com',
- *   apiKey: 'upk_...',
+ *   apiKey: 'upf_...',
  * });
  *
  * const result = await client.upload(file, { folderPath: 'uploads/' });
@@ -95,7 +120,14 @@ declare class UpfilesClient {
     private completionPath;
     private foldersPath;
     private callCompletionEndpoint;
+    private getToken?;
+    private projectId?;
+    private projectName?;
     constructor(opts: UpfilesClientOptions);
+    /** Build auth headers for API requests. Priority: getToken (JWT) > apiKey > static headers */
+    private buildAuthHeaders;
+    /** Get storage quota info for the project */
+    getQuota(): Promise<QuotaInfo>;
     getPresignedUrl(params: {
         fileName: string;
         fileType: string;
@@ -109,6 +141,7 @@ declare class UpfilesClient {
         folderPath?: string;
         fetchThumbnails?: boolean;
         callCompletionEndpoint?: boolean;
+        userId?: string;
     }): Promise<UploadedFileResult>;
     completeUpload(params: {
         fileKey: string;
@@ -116,6 +149,8 @@ declare class UpfilesClient {
         size: number;
         contentType: string;
         projectId?: string;
+        url?: string;
+        userId?: string;
     }): Promise<{
         success: boolean;
         file: {
@@ -134,13 +169,26 @@ declare class UpfilesClient {
         };
     }>;
     getThumbnails(fileKey: string): Promise<Thumbnail[]>;
-    generateThumbnails(fileKey: string): Promise<{
+    generateThumbnails(fileKey: string, sizes?: number[]): Promise<{
         masterWebp?: {
             key: string;
             url: string;
         };
         thumbnails: Thumbnail[];
     }>;
+    /** Get thumbnail settings for the project (requires API key) */
+    getThumbnailSettings(): Promise<{
+        enabled: boolean;
+        sizes: number[];
+    }>;
+    /** Update thumbnail settings for the project (requires API key with write scope) */
+    updateThumbnailSettings(settings: {
+        enabled?: boolean;
+        sizes?: number[];
+    }): Promise<{
+        enabled: boolean;
+        sizes: number[];
+    }>;
     getFolders(parentId?: string): Promise<Folder[]>;
     createFolder(name: string, parentId?: string): Promise<Folder>;
     getProjectFiles(params?: {
@@ -165,6 +213,10 @@ type UploaderFile = {
     fileKey?: string;
     projectId?: string;
     apiKeyId?: string;
+    /** Whether thumbnails should be generated for this file (set from per-file selection) */
+    thumbnailEnabled?: boolean;
+    /** Which thumbnail sizes were selected for this file */
+    thumbnailSizesSelected?: number[];
 };
 type UploaderProps = {
     clientOptions?: UpfilesClientOptions;
@@ -173,6 +225,7 @@ type UploaderProps = {
     maxFileSize?: number;
     maxFiles?: number;
     projectId?: string;
+    userId?: string;
     folderPath?: string;
     onComplete?: (files: UploaderFile[]) => void;
     onError?: (error: Error) => void;
@@ -182,13 +235,20 @@ type UploaderProps = {
     className?: string;
     buttonClassName?: string;
     dropzoneClassName?: string;
-    children?: React.ReactNode;
+    children?: React__default.ReactNode;
     fetchThumbnails?: boolean;
     autoRecordToDb?: boolean;
     recordUrl?: string;
     autoUpload?: boolean;
+    /**
+     * If defined, show the per-image thumbnail configuration panel.
+     * Value is the initial enabled state (default: true when panel is shown).
+     */
+    thumbnailEnabled?: boolean;
+    /** Default thumbnail sizes to generate. Supported: 64, 128, 256, 512. Default: [256, 512] */
+    thumbnailSizes?: number[];
 };
-declare const Uploader: React.FC<UploaderProps>;
+declare const Uploader: React__default.FC<UploaderProps>;
 
 type ProjectFilesWidgetProps = {
     clientOptions: UpfilesClientOptions;
@@ -217,7 +277,7 @@ type ProjectFilesWidgetProps = {
     showDelete?: boolean;
     refreshInterval?: number;
 };
-declare const ProjectFilesWidget: React.FC<ProjectFilesWidgetProps>;
+declare const ProjectFilesWidget: React__default.FC<ProjectFilesWidgetProps>;
 
 type ConnectProjectDialogProps = {
     baseUrl: string;
@@ -232,11 +292,12 @@ type ConnectProjectDialogProps = {
     description?: string;
     className?: string;
 };
-declare function ConnectProjectDialog(props: ConnectProjectDialogProps): react_jsx_runtime.JSX.Element;
+declare function ConnectProjectDialog(props: ConnectProjectDialogProps): React.JSX.Element;
 
 type ConnectOptions = {
     baseUrl: string;
     fetch?: typeof fetch;
+    token?: string;
 };
 type Project = {
     id: string;
@@ -245,12 +306,25 @@ type Project = {
 };
 declare function listProjects(opts: ConnectOptions): Promise<Project[]>;
 declare function createProject(opts: ConnectOptions & {
+    name: string;
+    isInHouse?: boolean;
+    freeStorageLimitBytes?: number;
+}): Promise<{
+    projectId: string;
+    project: Project | undefined;
+}>;
+declare function createProjectWithApiKey(opts: ConnectOptions & {
     name: string;
     keyName?: string;
 }): Promise<{
     apiKey: string;
     projectId: string;
 }>;
+declare function updateProject(opts: ConnectOptions & {
+    projectId: string;
+    isInHouse?: boolean;
+    freeStorageLimitBytes?: number;
+}): Promise<void>;
 declare function connectProject(opts: ConnectOptions & {
     projectId: string;
     keyName?: string;
@@ -286,12 +360,19 @@ declare function fetchProjectImagesWithThumbs(clientOptions: UpfilesClientOption
     updatedAt: string | null;
 }>;
 
+type ThumbnailConfig = {
+    /** Whether thumbnail generation is enabled (default: true) */
+    enabled?: boolean;
+    /** Pixel sizes to generate. Supported: 64, 128, 256, 512. Default: [256, 512] */
+    sizes?: number[];
+};
 type ImageManagerProps = {
     open: boolean;
     onOpenChange: (open: boolean) => void;
     clientOptions: UpfilesClientOptions;
     projectId?: string;
     folderPath?: string;
+    userId?: string;
     title?: string;
     description?: string;
     className?: string;
@@ -326,7 +407,42 @@ type ImageManagerProps = {
     mode?: 'full' | 'browse' | 'upload';
     showDelete?: boolean;
     refreshInterval?: number;
+    stayOnUploadAfterComplete?: boolean;
+    /** Thumbnail generation config. Users can override per-upload in the upload panel. */
+    thumbnailConfig?: ThumbnailConfig;
+};
+declare function ImageManager(props: ImageManagerProps): React.JSX.Element;
+
+type InhouseConfig = {
+    /** Upfiles backend base URL (e.g., http://localhost:4021) */
+    baseUrl: string;
+    /** Function returning the current JWT token, or a token string directly */
+    getToken: (() => string | null | undefined | Promise<string | null | undefined>) | string | null | undefined;
+    /** Current user ID. Required before in-house provisioning starts. */
+    userId: string | null | undefined;
+    /** Project name to auto-create (default: 'default') */
+    projectName?: string;
+    /** @deprecated In-house project data is no longer cached in browser storage. */
+    cachePrefix?: string;
+    /** Whether to enable auto-connect (default: true) */
+    enabled?: boolean;
+};
+type InhouseResult = {
+    /** Ready-to-use UpfilesClientOptions for ImageManager, Uploader, etc. */
+    clientOptions: UpfilesClientOptions | null;
+    /** Project ID is intentionally not exposed in secure in-house mode. */
+    projectId: string | null;
+    /** Whether the hook is currently provisioning */
+    loading: boolean;
+    /** Error message if provisioning failed */
+    error: string | null;
+    /** Whether credentials are ready to use */
+    isReady: boolean;
+    /** Force re-provision. */
+    retry: () => void;
+    /** Clear in-memory credentials. */
+    clearCache: () => void;
 };
-declare function ImageManager(props: ImageManagerProps): react_jsx_runtime.JSX.Element;
+declare function useUpfilesInhouse(config: InhouseConfig): InhouseResult;
 
-export { type ConnectOptions, ConnectProjectDialog, type ConnectProjectDialogProps, type FileListItem, type Folder, ImageManager, type ImageManagerProps, type ImageWithThumbs, type PresignResponse, type Project, ProjectFilesWidget, type ProjectFilesWidgetProps, type Thumbnail, UpfilesClient, type UpfilesClientOptions, type UploadedFileResult, Uploader, type UploaderFile, type UploaderProps, addApiKeyManually, connectProject, connectUsingApiKey, createClientWithKey, createProject, fetchFileThumbnails, fetchProjectFiles, fetchProjectImagesWithThumbs, listProjects };
+export { type ConnectOptions, ConnectProjectDialog, type ConnectProjectDialogProps, type FileListItem, type Folder, ImageManager, type ImageManagerProps, type ImageWithThumbs, type InhouseConfig, type InhouseResult, type PresignResponse, type Project, ProjectFilesWidget, type ProjectFilesWidgetProps, type QuotaInfo, StorageQuotaError, type Thumbnail, type ThumbnailConfig, UpfilesClient, type UpfilesClientOptions, type UploadedFileResult, Uploader, type UploaderFile, type UploaderProps, addApiKeyManually, connectProject, connectUsingApiKey, createClientWithKey, createProject, createProjectWithApiKey, fetchFileThumbnails, fetchProjectFiles, fetchProjectImagesWithThumbs, listProjects, updateProject, useUpfilesInhouse };

package/dist/index.d.ts

@@ -1,6 +1,25 @@
-import React from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import React__default from 'react';
 
+type QuotaInfo = {
+    limitBytes: number;
+    usedBytes: number;
+    remainingBytes: number;
+};
+declare class StorageQuotaError extends Error {
+    details?: {
+        limit: number;
+        used: number;
+        remaining: number;
+        fileSize: number;
+    };
+    constructor(message: string, details?: {
+        limit: number;
+        used: number;
+        remaining: number;
+        fileSize: number;
+    });
+}
 type PresignResponse = {
     presignedUrl: string;
     fileKey: string;
@@ -51,7 +70,7 @@ type FileListItem = {
  * ```ts
  * const client = new UpfilesClient({
  *   baseUrl: 'https://your-upfiles.example.com',
- *   apiKey: 'upk_...',
+ *   apiKey: 'upf_...',
  * });
  * ```
  */
@@ -67,6 +86,12 @@ type UpfilesClientOptions = {
     completionPath?: string;
     foldersPath?: string;
     callCompletionEndpoint?: boolean;
+    /** Dynamic token getter for JWT-based auth (inhouse mode). Called on each request for fresh token. Takes priority over apiKey. */
+    getToken?: () => string | null | undefined | Promise<string | null | undefined>;
+    /** Project ID sent as x-project-id header when using getToken (JWT auth) */
+    projectId?: string;
+    /** Project name sent as x-project-name in in-house mode so the browser does not need the project id. */
+    projectName?: string;
 };
 /**
  * UpfilesClient - Main client class for interacting with Upfiles Plugin API
@@ -77,7 +102,7 @@ type UpfilesClientOptions = {
  * ```ts
  * const client = new UpfilesClient({
  *   baseUrl: 'https://your-upfiles.example.com',
- *   apiKey: 'upk_...',
+ *   apiKey: 'upf_...',
  * });
  *
  * const result = await client.upload(file, { folderPath: 'uploads/' });
@@ -95,7 +120,14 @@ declare class UpfilesClient {
     private completionPath;
     private foldersPath;
     private callCompletionEndpoint;
+    private getToken?;
+    private projectId?;
+    private projectName?;
     constructor(opts: UpfilesClientOptions);
+    /** Build auth headers for API requests. Priority: getToken (JWT) > apiKey > static headers */
+    private buildAuthHeaders;
+    /** Get storage quota info for the project */
+    getQuota(): Promise<QuotaInfo>;
     getPresignedUrl(params: {
         fileName: string;
         fileType: string;
@@ -109,6 +141,7 @@ declare class UpfilesClient {
         folderPath?: string;
         fetchThumbnails?: boolean;
         callCompletionEndpoint?: boolean;
+        userId?: string;
     }): Promise<UploadedFileResult>;
     completeUpload(params: {
         fileKey: string;
@@ -116,6 +149,8 @@ declare class UpfilesClient {
         size: number;
         contentType: string;
         projectId?: string;
+        url?: string;
+        userId?: string;
     }): Promise<{
         success: boolean;
         file: {
@@ -134,13 +169,26 @@ declare class UpfilesClient {
         };
     }>;
     getThumbnails(fileKey: string): Promise<Thumbnail[]>;
-    generateThumbnails(fileKey: string): Promise<{
+    generateThumbnails(fileKey: string, sizes?: number[]): Promise<{
         masterWebp?: {
             key: string;
             url: string;
         };
         thumbnails: Thumbnail[];
     }>;
+    /** Get thumbnail settings for the project (requires API key) */
+    getThumbnailSettings(): Promise<{
+        enabled: boolean;
+        sizes: number[];
+    }>;
+    /** Update thumbnail settings for the project (requires API key with write scope) */
+    updateThumbnailSettings(settings: {
+        enabled?: boolean;
+        sizes?: number[];
+    }): Promise<{
+        enabled: boolean;
+        sizes: number[];
+    }>;
     getFolders(parentId?: string): Promise<Folder[]>;
     createFolder(name: string, parentId?: string): Promise<Folder>;
     getProjectFiles(params?: {
@@ -165,6 +213,10 @@ type UploaderFile = {
     fileKey?: string;
     projectId?: string;
     apiKeyId?: string;
+    /** Whether thumbnails should be generated for this file (set from per-file selection) */
+    thumbnailEnabled?: boolean;
+    /** Which thumbnail sizes were selected for this file */
+    thumbnailSizesSelected?: number[];
 };
 type UploaderProps = {
     clientOptions?: UpfilesClientOptions;
@@ -173,6 +225,7 @@ type UploaderProps = {
     maxFileSize?: number;
     maxFiles?: number;
     projectId?: string;
+    userId?: string;
     folderPath?: string;
     onComplete?: (files: UploaderFile[]) => void;
     onError?: (error: Error) => void;
@@ -182,13 +235,20 @@ type UploaderProps = {
     className?: string;
     buttonClassName?: string;
     dropzoneClassName?: string;
-    children?: React.ReactNode;
+    children?: React__default.ReactNode;
     fetchThumbnails?: boolean;
     autoRecordToDb?: boolean;
     recordUrl?: string;
     autoUpload?: boolean;
+    /**
+     * If defined, show the per-image thumbnail configuration panel.
+     * Value is the initial enabled state (default: true when panel is shown).
+     */
+    thumbnailEnabled?: boolean;
+    /** Default thumbnail sizes to generate. Supported: 64, 128, 256, 512. Default: [256, 512] */
+    thumbnailSizes?: number[];
 };
-declare const Uploader: React.FC<UploaderProps>;
+declare const Uploader: React__default.FC<UploaderProps>;
 
 type ProjectFilesWidgetProps = {
     clientOptions: UpfilesClientOptions;
@@ -217,7 +277,7 @@ type ProjectFilesWidgetProps = {
     showDelete?: boolean;
     refreshInterval?: number;
 };
-declare const ProjectFilesWidget: React.FC<ProjectFilesWidgetProps>;
+declare const ProjectFilesWidget: React__default.FC<ProjectFilesWidgetProps>;
 
 type ConnectProjectDialogProps = {
     baseUrl: string;
@@ -232,11 +292,12 @@ type ConnectProjectDialogProps = {
     description?: string;
     className?: string;
 };
-declare function ConnectProjectDialog(props: ConnectProjectDialogProps): react_jsx_runtime.JSX.Element;
+declare function ConnectProjectDialog(props: ConnectProjectDialogProps): React.JSX.Element;
 
 type ConnectOptions = {
     baseUrl: string;
     fetch?: typeof fetch;
+    token?: string;
 };
 type Project = {
     id: string;
@@ -245,12 +306,25 @@ type Project = {
 };
 declare function listProjects(opts: ConnectOptions): Promise<Project[]>;
 declare function createProject(opts: ConnectOptions & {
+    name: string;
+    isInHouse?: boolean;
+    freeStorageLimitBytes?: number;
+}): Promise<{
+    projectId: string;
+    project: Project | undefined;
+}>;
+declare function createProjectWithApiKey(opts: ConnectOptions & {
     name: string;
     keyName?: string;
 }): Promise<{
     apiKey: string;
     projectId: string;
 }>;
+declare function updateProject(opts: ConnectOptions & {
+    projectId: string;
+    isInHouse?: boolean;
+    freeStorageLimitBytes?: number;
+}): Promise<void>;
 declare function connectProject(opts: ConnectOptions & {
     projectId: string;
     keyName?: string;
@@ -286,12 +360,19 @@ declare function fetchProjectImagesWithThumbs(clientOptions: UpfilesClientOption
     updatedAt: string | null;
 }>;
 
+type ThumbnailConfig = {
+    /** Whether thumbnail generation is enabled (default: true) */
+    enabled?: boolean;
+    /** Pixel sizes to generate. Supported: 64, 128, 256, 512. Default: [256, 512] */
+    sizes?: number[];
+};
 type ImageManagerProps = {
     open: boolean;
     onOpenChange: (open: boolean) => void;
     clientOptions: UpfilesClientOptions;
     projectId?: string;
     folderPath?: string;
+    userId?: string;
     title?: string;
     description?: string;
     className?: string;
@@ -326,7 +407,42 @@ type ImageManagerProps = {
     mode?: 'full' | 'browse' | 'upload';
     showDelete?: boolean;
     refreshInterval?: number;
+    stayOnUploadAfterComplete?: boolean;
+    /** Thumbnail generation config. Users can override per-upload in the upload panel. */
+    thumbnailConfig?: ThumbnailConfig;
+};
+declare function ImageManager(props: ImageManagerProps): React.JSX.Element;
+
+type InhouseConfig = {
+    /** Upfiles backend base URL (e.g., http://localhost:4021) */
+    baseUrl: string;
+    /** Function returning the current JWT token, or a token string directly */
+    getToken: (() => string | null | undefined | Promise<string | null | undefined>) | string | null | undefined;
+    /** Current user ID. Required before in-house provisioning starts. */
+    userId: string | null | undefined;
+    /** Project name to auto-create (default: 'default') */
+    projectName?: string;
+    /** @deprecated In-house project data is no longer cached in browser storage. */
+    cachePrefix?: string;
+    /** Whether to enable auto-connect (default: true) */
+    enabled?: boolean;
+};
+type InhouseResult = {
+    /** Ready-to-use UpfilesClientOptions for ImageManager, Uploader, etc. */
+    clientOptions: UpfilesClientOptions | null;
+    /** Project ID is intentionally not exposed in secure in-house mode. */
+    projectId: string | null;
+    /** Whether the hook is currently provisioning */
+    loading: boolean;
+    /** Error message if provisioning failed */
+    error: string | null;
+    /** Whether credentials are ready to use */
+    isReady: boolean;
+    /** Force re-provision. */
+    retry: () => void;
+    /** Clear in-memory credentials. */
+    clearCache: () => void;
 };
-declare function ImageManager(props: ImageManagerProps): react_jsx_runtime.JSX.Element;
+declare function useUpfilesInhouse(config: InhouseConfig): InhouseResult;
 
-export { type ConnectOptions, ConnectProjectDialog, type ConnectProjectDialogProps, type FileListItem, type Folder, ImageManager, type ImageManagerProps, type ImageWithThumbs, type PresignResponse, type Project, ProjectFilesWidget, type ProjectFilesWidgetProps, type Thumbnail, UpfilesClient, type UpfilesClientOptions, type UploadedFileResult, Uploader, type UploaderFile, type UploaderProps, addApiKeyManually, connectProject, connectUsingApiKey, createClientWithKey, createProject, fetchFileThumbnails, fetchProjectFiles, fetchProjectImagesWithThumbs, listProjects };
+export { type ConnectOptions, ConnectProjectDialog, type ConnectProjectDialogProps, type FileListItem, type Folder, ImageManager, type ImageManagerProps, type ImageWithThumbs, type InhouseConfig, type InhouseResult, type PresignResponse, type Project, ProjectFilesWidget, type ProjectFilesWidgetProps, type QuotaInfo, StorageQuotaError, type Thumbnail, type ThumbnailConfig, UpfilesClient, type UpfilesClientOptions, type UploadedFileResult, Uploader, type UploaderFile, type UploaderProps, addApiKeyManually, connectProject, connectUsingApiKey, createClientWithKey, createProject, createProjectWithApiKey, fetchFileThumbnails, fetchProjectFiles, fetchProjectImagesWithThumbs, listProjects, updateProject, useUpfilesInhouse };