@pipedream/connect-react 2.5.0 → 2.6.0

package/dist/connect-react.umd.d.ts

@@ -126,6 +126,57 @@ declare type ComponentFormProps<T extends ConfigurableProps, U = ConfiguredProps
 
 export declare type ComponentLibrary = typeof defaultComponents;
 
+/**
+ * A file picker component that uses the Pipedream SDK's configure endpoint
+ * to fetch options for component props, rendering them in a file browser UI.
+ */
+export declare const ConfigureFilePicker: FC<ConfigureFilePickerProps>;
+
+export declare const ConfigureFilePickerModal: FC<ConfigureFilePickerModalProps>;
+
+export declare interface ConfigureFilePickerModalProps extends ConfigureFilePickerProps {
+    isOpen: boolean;
+    title?: string;
+}
+
+/**
+ * Props for the ConfigureFilePicker component
+ */
+export declare interface ConfigureFilePickerProps {
+    /** Component key to use for the file picker (e.g., "sharepoint-select-file") */
+    componentKey: string;
+    /** App slug (e.g., "sharepoint") - used for app-specific config */
+    app: string;
+    /** Connected account ID */
+    accountId: string;
+    /** External user ID for the Pipedream Connect session */
+    externalUserId: string;
+    /** Callback when user confirms their selection */
+    onSelect: (items: FilePickerItem[], configuredProps: Record<string, unknown>) => void;
+    /** Callback when user cancels */
+    onCancel?: () => void;
+    /** Initial configured props (for restoring previous selection) */
+    initialConfiguredProps?: Record<string, unknown>;
+    /** Confirm button text */
+    confirmText?: string;
+    /** Cancel button text */
+    cancelText?: string;
+    /** Allow selecting folders (default: true) */
+    selectFolders?: boolean;
+    /** Allow selecting files (default: true) */
+    selectFiles?: boolean;
+    /** Allow selecting multiple items (default: false) */
+    multiSelect?: boolean;
+    /** Custom app configuration (overrides built-in config for the app) */
+    appConfig?: FilePickerAppConfig;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+    /** Whether to show file/folder icons (default: true) */
+    showIcons?: boolean;
+    /** Custom icons for files and folders. Can be strings (emoji) or ReactNodes. */
+    icons?: FilePickerIcons;
+}
+
 export declare function Control<T extends ConfigurableProps, U extends ConfigurableProp>(props: ControlProps<T, U>): JSX_2.Element;
 
 export declare function ControlAny(): JSX_2.Element;
@@ -320,6 +371,51 @@ declare type FieldProps<T extends ConfigurableProp> = {
     field: FormFieldContext<T>;
 };
 
+/**
+ * Pre-built app configurations
+ */
+export declare const FILE_PICKER_APPS: Record<string, FilePickerAppConfig>;
+
+/**
+ * App-specific configuration for the file picker
+ */
+export declare interface FilePickerAppConfig {
+    /** App slug (e.g., "sharepoint", "google_drive", "dropbox") */
+    app: string;
+    /** The camelCase prop name used in the component (e.g., "sharepoint") */
+    appPropName: string;
+    /** Prop hierarchy to navigate through (e.g., ["siteId", "driveId", "fileOrFolderIds"]) */
+    propHierarchy: string[];
+    /** Prop labels for display (e.g., { siteId: "Sites", driveId: "Drives" }) */
+    propLabels: Record<string, string>;
+    /** The prop name that shows selectable files/folders */
+    fileOrFolderProp: string;
+    /** The prop name used for folder navigation (set when drilling into folders) */
+    folderProp?: string;
+}
+
+/**
+ * Icon configuration for the file picker
+ */
+export declare interface FilePickerIcons {
+    /** Icon for folders (string emoji or ReactNode) */
+    folder?: ReactNode;
+    /** Icon for files (string emoji or ReactNode) */
+    file?: ReactNode;
+}
+
+/**
+ * Represents an item (file or folder) in the file picker
+ */
+export declare interface FilePickerItem {
+    id: string;
+    label: string;
+    value: unknown;
+    isFolder?: boolean;
+    size?: number;
+    raw?: unknown;
+}
+
 export declare type FormContext<T extends ConfigurableProps> = {
     component: Component;
     configurableProps: T;
@@ -403,6 +499,15 @@ declare const LoadMoreButton: (props: ButtonProps) => JSX_2.Element;
 
 export declare function mergeTheme(target: Theme, ...sources: (PartialTheme | undefined)[]): Theme;
 
+/**
+ * Represents a navigation level in the picker hierarchy
+ */
+export declare interface NavigationLevel {
+    propName: string;
+    label: string;
+    value: unknown;
+}
+
 export declare const OptionalFieldButton: (props: OptionalFieldButtonProps) => JSX_2.Element;
 
 declare type OptionalFieldButtonProps = {