@pipedream/connect-react 2.4.1 → 2.6.0

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

@@ -8,8 +8,6 @@ import { ComponentProps } from 'react';
 import { ComponentsListRequest } from '@pipedream/sdk';
 import { ConfigurableProp } from '@pipedream/sdk';
 import { ConfigurablePropAlert } from '@pipedream/sdk';
-import { ConfigurablePropApp } from '@pipedream/sdk';
-import { ConfigurablePropBoolean } from '@pipedream/sdk';
 import { ConfigurableProps } from '@pipedream/sdk';
 import { ConfiguredProps } from '@pipedream/sdk';
 import { Context } from 'react';
@@ -128,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;
@@ -190,11 +239,11 @@ export declare type CustomComponentsConfig<T, U extends boolean, V extends Group
 
 export declare type CustomizableProps = {
     componentForm: ComponentProps<typeof ComponentForm>;
-    connectButton: ComponentProps<typeof ControlApp> & FormFieldContext<ConfigurablePropApp>;
+    connectButton: ComponentProps<typeof ControlApp> & FormFieldContext<ConfigurableProp.App>;
     controlAny: ComponentProps<typeof ControlAny> & FormFieldContext<ConfigurableProp>;
-    controlApp: ComponentProps<typeof ControlApp> & FormFieldContext<ConfigurablePropApp>;
+    controlApp: ComponentProps<typeof ControlApp> & FormFieldContext<ConfigurableProp.App>;
     controlArray: ComponentProps<typeof ControlArray> & FormFieldContext<ConfigurableProp>;
-    controlBoolean: ComponentProps<typeof ControlBoolean> & FormFieldContext<ConfigurablePropBoolean>;
+    controlBoolean: ComponentProps<typeof ControlBoolean> & FormFieldContext<ConfigurableProp.Boolean>;
     controlHttpRequest: ComponentProps<typeof ControlHttpRequest> & FormFieldContext<ConfigurableProp>;
     controlInput: ComponentProps<typeof ControlInput> & FormFieldContext<ConfigurableProp>;
     controlObject: ComponentProps<typeof ControlObject> & FormFieldContext<ConfigurableProp>;
@@ -322,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;
@@ -372,7 +466,7 @@ export declare type FormFieldContext<T extends ConfigurableProp> = {
 
 export declare const FormFieldContext: Context<FormFieldContext<any> | undefined>;
 
-export declare type FormFieldContextExtra<T extends ConfigurableProp> = T extends ConfigurablePropApp ? {
+export declare type FormFieldContextExtra<T extends ConfigurableProp> = T extends ConfigurableProp.App ? {
     app?: App;
 } : object;
 
@@ -405,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 = {
@@ -456,7 +559,7 @@ declare type SelectAppProps = {
     appsOptions?: Omit<AppsListRequest, "q">;
 };
 
-export declare function SelectComponent({ app, componentType, value, onChange, }: SelectComponentProps): JSX_2.Element;
+export declare function SelectComponent({ app, componentType, value, onChange, componentsOptions, }: SelectComponentProps): JSX_2.Element;
 
 declare type SelectComponentProps = {
     app?: Partial<App> & {
@@ -467,6 +570,10 @@ declare type SelectComponentProps = {
         key: string;
     };
     onChange?: (component?: Component) => void;
+    /**
+     * Additional options for fetching components (e.g., registry)
+     */
+    componentsOptions?: Omit<ComponentsListRequest, "app" | "componentType">;
 };
 
 export declare type Shadows = {