@expresscsv/react 0.1.20 → 0.1.22

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/@expresscsv/react.svg)](https://www.npmjs.com/package/@expresscsv/react)
 ![license](https://img.shields.io/npm/l/@expresscsv/react.svg)
 
-React hook for embedding the [ExpressCSV](https://expresscsv.com) CSV import widget. Wraps [`@expresscsv/sdk`](https://www.npmjs.com/package/@expresscsv/sdk) with automatic lifecycle management and reactive state.
+React hook for embedding the [ExpressCSV](https://expresscsv.com) CSV importer. Wraps [`@expresscsv/sdk`](https://www.npmjs.com/package/@expresscsv/sdk) with automatic lifecycle management and reactive state.
 
 If you want to define schemas in shared or backend code without any frontend dependencies, use [`@expresscsv/schemas`](https://www.npmjs.com/package/@expresscsv/schemas) for the schema definition itself, then pass that schema into `@expresscsv/react`.
 
@@ -36,7 +36,7 @@ const schema = x.row({
 function App() {
   const { open, isOpen } = useExpressCSV({
     schema,
-    publishableKey: "your-publishable-key",
+    getSessionToken: async () => fetchSessionToken(),
     importIdentifier: "user-import",
     title: "Import Users",
   });
@@ -71,20 +71,20 @@ function App() {
 }
 ```
 
-Your `publishableKey` is available from the [ExpressCSV dashboard](https://expresscsv.com). Two key types are available: **production** keys for live usage, and **dev/testing** keys that provide unlimited test imports.
+Have your backend keep the ExpressCSV secret key, call the ExpressCSV session-creation endpoint, and return a short-lived importer session token to the browser via `getSessionToken`.
 
 ## Preloading
 
-By default the widget preloads in a hidden iframe so it appears instantly when `open()` is called:
+By default the importer preloads in a hidden iframe so it appears instantly when `open()` is called:
 
 ```tsx
 const { open } = useExpressCSV({
   schema,
-  publishableKey: "your-publishable-key",
+  getSessionToken: async () => fetchSessionToken(),
   importIdentifier: "user-import",
 });
 
-// Widget displays instantly
+// Importer displays instantly
 const handleImport = () => {
   open({
     onData: (chunk, next) => {
@@ -100,7 +100,7 @@ To disable preloading (there will be a brief loading screen instead):
 ```tsx
 const { open } = useExpressCSV({
   schema,
-  publishableKey: "your-publishable-key",
+  getSessionToken: async () => fetchSessionToken(),
   importIdentifier: "user-import",
   preload: false,
 });
@@ -124,7 +124,7 @@ const candidateSchema = x.row({
 
 const { open } = useExpressCSV({
   schema: candidateSchema,
-  publishableKey: "your-publishable-key",
+  getSessionToken: async () => fetchSessionToken(),
   importIdentifier: "candidate-import",
   templateDownload: {
     source: "generate",
@@ -142,7 +142,7 @@ const { open } = useExpressCSV({
 
 ## Theming and Styling
 
-Customize the widget's appearance with the `theme`, `colorMode`, `customCSS`, and `fonts` options.
+Customize the importer's appearance with the `theme`, `colorMode`, `customCSS`, and `fonts` options.
 
 ### Theme
 
@@ -181,7 +181,7 @@ const dualTheme: ECSVTheme = {
 function App() {
   const { open } = useExpressCSV({
     schema,
-    publishableKey: "your-publishable-key",
+    getSessionToken: async () => fetchSessionToken(),
     importIdentifier: "user-import",
     theme,
   });
@@ -227,7 +227,7 @@ Control light/dark mode with `colorMode`:
 ```tsx
 const { open } = useExpressCSV({
   schema,
-  publishableKey: "your-publishable-key",
+  getSessionToken: async () => fetchSessionToken(),
   importIdentifier: "user-import",
   colorMode: "system", // 'light' | 'dark' | 'system'
 });
@@ -240,7 +240,7 @@ Inject custom CSS for fine-grained styling overrides.
 ```tsx
 const { open } = useExpressCSV({
   schema,
-  publishableKey: "your-publishable-key",
+  getSessionToken: async () => fetchSessionToken(),
   importIdentifier: "user-import",
   customCSS: `
     .ecsv [data-step="upload"] {
@@ -260,7 +260,7 @@ Load custom fonts via the `fonts` option:
 ```tsx
 const { open } = useExpressCSV({
   schema,
-  publishableKey: "your-publishable-key",
+  getSessionToken: async () => fetchSessionToken(),
   importIdentifier: "user-import",
   fonts: {
     title: { source: "google", name: "Space Grotesk", weights: [400, 600, 700] },
@@ -288,7 +288,7 @@ const schema = x.row({
 function App() {
   const { open } = useExpressCSV({
     schema,
-    publishableKey: "your-publishable-key",
+    getSessionToken: async () => fetchSessionToken(),
     importIdentifier: "user-import",
     title: "Import Users",
   });
@@ -337,7 +337,6 @@ interface WebhookPayload {
   metadata?: Record<string, unknown>;
   /** Delivery context added by ExpressCSV */
   delivery: {
-    publishableKey: string;
     environmentName: string;
     environmentType: string;
     teamSlug: string;
@@ -366,7 +365,6 @@ Example payload:
     "userId": "user-123"
   },
   "delivery": {
-    "publishableKey": "pk_live_abc123",
     "environmentName": "Production",
     "environmentType": "production",
     "teamSlug": "my-team",
@@ -494,7 +492,7 @@ function CandidateImporter() {
 
   const { open, isOpen } = useExpressCSV({
     schema: candidateSchema,
-    publishableKey: "your-publishable-key",
+    getSessionToken: async () => fetchSessionToken(),
     importIdentifier: "candidate-import",
     title: "Import Candidates",
   });
@@ -542,7 +540,7 @@ function useExpressCSV<TSchema>(
   options: UseExpressCSVOptions<TSchema>
 ): {
   open: (options: OpenOptions<Infer<TSchema>>) => void;
-  widgetState: WidgetState;
+  importerState: ImporterState;
   isInitialising: boolean;
   isOpen: boolean;
 };
@@ -553,14 +551,14 @@ function useExpressCSV<TSchema>(
 | Option | Type | Required | Default | Description |
 |---|---|---|---|---|
 | `schema` | Schema | Yes | - | Schema definition created with `x.row()` |
-| `publishableKey` | `string` | Yes | - | Your publishable key from the [dashboard](https://expresscsv.com) |
+| `getSessionToken` | `() => Promise<string>` | Yes | - | Async callback that asks your backend for a short-lived importer session token |
 | `importIdentifier` | `string` | Yes | - | Unique identifier for this import type |
-| `title` | `string` | No | - | Title shown in the widget header |
-| `preload` | `boolean` | No | `true` | Preload widget for instant display |
+| `title` | `string` | No | - | Title shown in the importer header |
+| `preload` | `boolean` | No | `true` | Preload the importer for instant display |
 | `debug` | `boolean` | No | `false` | Enable debug logging |
 | `theme` | `ECSVTheme` | No | - | Custom theme configuration |
 | `colorMode` | `ColorModePref` | No | - | Light/dark mode (`'light'`, `'dark'`, or `'system'`) |
-| `customCSS` | `string` | No | - | Custom CSS to inject into the widget |
+| `customCSS` | `string` | No | - | Custom CSS to inject into the importer |
 | `fonts` | `Record<string, ECSVFontSource>` | No | - | Custom font sources |
 | `stepDisplay` | `'progressBar' \| 'segmented' \| 'numbered'` | No | `'progressBar'` | Step indicator style |
 | `previewSchemaBeforeUpload` | `boolean` | No | `true` | Show schema preview before upload |
@@ -572,10 +570,10 @@ function useExpressCSV<TSchema>(
 
 | Property | Type | Description |
 |---|---|---|
-| `open` | `(options: OpenOptions) => void` | Opens the widget. Requires at least one of `onData` or `webhook`. |
-| `widgetState` | `WidgetState` | Current widget state (reactive) |
-| `isInitialising` | `boolean` | `true` while the widget is initializing or opening |
-| `isOpen` | `boolean` | `true` while the widget is open |
+| `open` | `(options: OpenOptions) => void` | Opens the importer. Requires at least one of `onData` or `webhook`. |
+| `importerState` | `ImporterState` | Current importer lifecycle state (reactive) |
+| `isInitialising` | `boolean` | `true` while the importer is initializing or opening |
+| `isOpen` | `boolean` | `true` while the importer is open |
 
 ### `OpenOptions<T>`
 
@@ -589,8 +587,8 @@ Options passed to `open()`. At least one of `onData` or `webhook` must be provid
 | `onComplete` | `() => void` | No | Called when all chunks have been processed |
 | `onCancel` | `() => void` | No | Called when the user cancels the import |
 | `onError` | `(error: Error) => void` | No | Called when an error occurs |
-| `onWidgetOpen` | `() => void` | No | Called when the widget opens |
-| `onWidgetClose` | `(reason: string) => void` | No | Called when the widget closes |
+| `onImporterOpen` | `() => void` | No | Called when the importer opens |
+| `onImporterClose` | `(reason: string) => void` | No | Called when the importer closes |
 | `onStepChange` | `(stepId, previousStepId?) => void` | No | Called when the wizard step changes |
 
 \* At least one of `onData` or `webhook` is required.
@@ -623,7 +621,7 @@ interface WebhookConfig {
 
 The `x` schema builder provides a type-safe, fluent API for defining your CSV structure.
 
-For apps that share schemas with backend code or webhook receivers, prefer defining the schema in `@expresscsv/schemas` and importing it into your React app. That keeps schema authoring free of React and widget dependencies, while also giving your backend access to `InferWebhookPayload<typeof schema>`.
+For apps that share schemas with backend code or webhook receivers, prefer defining the schema in `@expresscsv/schemas` and importing it into your React app. That keeps schema authoring free of React and importer dependencies, while also giving your backend access to `InferWebhookPayload<typeof schema>`.
 
 #### Field Types
 
@@ -728,7 +726,7 @@ All field types support:
 
 | Modifier | Description |
 |---|---|
-| `.label(text)` | User-facing label shown in the widget |
+| `.label(text)` | User-facing label shown in the importer |
 | `.description(text)` | Help text for the field |
 | `.example(text)` | Example value shown as placeholder |
 | `.optional()` | Makes the field optional (default is required) |
@@ -780,7 +778,7 @@ x.string().refine(
 )
 ```
 
-**Object-returning validator** — inline `valid`, `message`, and an optional `suggestedFix` the widget can offer the user:
+**Object-returning validator** — inline `valid`, `message`, and an optional `suggestedFix` the importer can offer the user:
 
 ```tsx
 x.string().refine((value) => ({
@@ -847,7 +845,7 @@ x.string().refineBatch((values) => {
 
 ### `suggestedFix`
 
-Both `.refine()` and `.refineBatch()` support returning a `suggestedFix` object that the widget offers as a one-click fix for the user:
+Both `.refine()` and `.refineBatch()` support returning a `suggestedFix` object that the importer offers as a one-click fix for the user:
 
 ```tsx
 interface SuggestedFix {

package/dist/index.d.cts

@@ -2754,7 +2754,7 @@ declare interface ExpressCSVLocale {
         nextDisabledReviewValidating: string;
         nextDisabledReviewInvalid: string;
     };
-    widget: {
+    importer: {
         title: string;
         loading: string;
         closeConfirmTitle: string;
@@ -2763,7 +2763,6 @@ declare interface ExpressCSVLocale {
         closeConfirmContinue: string;
         errorTitle: string;
         startOver: string;
-        invalidPublishableKey: string;
     };
     sessionRecovery: {
         message: string;
@@ -2883,6 +2882,7 @@ declare interface ExpressCSVLocale {
     };
     review: {
         completing: string;
+        processing: string;
         loading: string;
         title: string;
         subtitle: string;
@@ -3475,6 +3475,29 @@ export declare class ImportCancelledError extends Error {
     constructor(message?: string);
 }
 
+/**
+ * Importer preload mode
+ */
+export declare enum ImporterMode {
+    NORMAL = "normal",
+    PRELOAD = "preload"
+}
+
+/**
+ * Importer lifecycle state
+ */
+export declare enum ImporterState {
+    UNINITIALIZED = "uninitialized",
+    INITIALIZING = "initializing",
+    READY = "ready",
+    OPENING = "opening",
+    OPEN = "open",
+    CLOSING = "closing",
+    RESETTING = "resetting",
+    ERROR = "error",
+    DESTROYED = "destroyed"
+}
+
 export declare type Infer<T extends ExType<unknown, ExBaseDef, unknown>> = T extends ExType<infer Output, ExBaseDef, unknown> ? Output : never;
 
 declare type IPAddressVersion = 'v4' | 'v6' | 'all';
@@ -3497,12 +3520,12 @@ export declare type OpenOptions<T> = RequireAtLeastOne<DeliveryOptionsBase<T>, '
     onCancel?: () => void;
     /** Called when an error occurs */
     onError?: (error: Error) => void;
-    /** Called when the widget opens */
-    onWidgetOpen?: () => void;
+    /** Called when the importer opens */
+    onImporterOpen?: () => void;
+    /** Called when the importer closes */
+    onImporterClose?: (reason: 'user_close' | 'cancel' | 'complete' | 'error') => void;
     /** Called when the step changes in the wizard */
     onStepChange?: (stepId: ExpressCSVStep, previousStepId?: ExpressCSVStep) => void;
-    /** Called when the widget closes */
-    onWidgetClose?: (reason: 'user_close' | 'cancel' | 'complete' | 'error') => void;
 };
 
 declare type PhoneNumberFormat = 'international' | 'national' | 'both';
@@ -3725,7 +3748,7 @@ export declare type TemplateDownloadOptions<TSchema extends ExType<unknown, ExBa
 
 /**
  * A branded string type for locale entries that require interpolation via `{variable}` syntax.
- * Widget code cannot render a `TemplateString` directly in JSX — it must go through the `t()` function.
+ * Importer code cannot render a `TemplateString` directly in JSX — it must go through the `t()` function.
  * The generic `TVars` encodes the expected variable names so `t()` enforces the correct vars argument.
  */
 declare type TemplateString<TVars extends string = string> = string & {
@@ -3749,9 +3772,9 @@ declare interface URLOptions {
     message?: string;
 }
 
-export declare function useExpressCSV<TSchema extends ExType<unknown, ExBaseDef, unknown>>({ schema, title, importIdentifier, publishableKey, debug, preload, theme, colorMode, customCSS, fonts, stepDisplay, previewSchemaBeforeUpload, templateDownload, saveSession, locale, disableStatusStep, }: UseExpressCSVOptions<TSchema>): {
+export declare function useExpressCSV<TSchema extends ExType<unknown, ExBaseDef, unknown>>({ schema, title, importIdentifier, getSessionToken, debug, preload, theme, colorMode, customCSS, fonts, stepDisplay, previewSchemaBeforeUpload, templateDownload, saveSession, locale, disableStatusStep, }: UseExpressCSVOptions<TSchema>): {
     open: (options: OpenOptions<Infer<TSchema>>) => void;
-    widgetState: WidgetState;
+    importerState: ImporterState;
     isInitialising: boolean;
     isOpen: boolean;
 };
@@ -3760,7 +3783,7 @@ export declare interface UseExpressCSVOptions<TSchema extends ExType<unknown, Ex
     schema: TSchema;
     title?: string;
     importIdentifier: string;
-    publishableKey: string;
+    getSessionToken: () => Promise<string>;
     debug?: boolean;
     preload?: boolean;
     theme?: ECSVTheme;
@@ -3803,34 +3826,11 @@ export declare interface WebhookConfig {
      * Whether to wait for the delivery service to confirm the webhook was
      * successfully received before considering the import complete.
      * When false, the import completes as soon as all chunks are queued.
-     * Default: true
+     * Default: false
      */
     awaitWebhookArrival?: boolean;
 }
 
-/**
- * Widget mode enumeration
- */
-export declare enum WidgetMode {
-    NORMAL = "normal",
-    PRELOAD = "preload"
-}
-
-/**
- * Widget state enumeration for consistent state management
- */
-export declare enum WidgetState {
-    UNINITIALIZED = "uninitialized",
-    INITIALIZING = "initializing",
-    READY = "ready",
-    OPENING = "opening",
-    OPEN = "open",
-    CLOSING = "closing",
-    RESETTING = "resetting",
-    ERROR = "error",
-    DESTROYED = "destroyed"
-}
-
 export declare const x: {
     string: typeof ExString.create;
     number: typeof ExNumber.create;

package/dist/index.d.mts

@@ -2754,7 +2754,7 @@ declare interface ExpressCSVLocale {
         nextDisabledReviewValidating: string;
         nextDisabledReviewInvalid: string;
     };
-    widget: {
+    importer: {
         title: string;
         loading: string;
         closeConfirmTitle: string;
@@ -2763,7 +2763,6 @@ declare interface ExpressCSVLocale {
         closeConfirmContinue: string;
         errorTitle: string;
         startOver: string;
-        invalidPublishableKey: string;
     };
     sessionRecovery: {
         message: string;
@@ -2883,6 +2882,7 @@ declare interface ExpressCSVLocale {
     };
     review: {
         completing: string;
+        processing: string;
         loading: string;
         title: string;
         subtitle: string;
@@ -3475,6 +3475,29 @@ export declare class ImportCancelledError extends Error {
     constructor(message?: string);
 }
 
+/**
+ * Importer preload mode
+ */
+export declare enum ImporterMode {
+    NORMAL = "normal",
+    PRELOAD = "preload"
+}
+
+/**
+ * Importer lifecycle state
+ */
+export declare enum ImporterState {
+    UNINITIALIZED = "uninitialized",
+    INITIALIZING = "initializing",
+    READY = "ready",
+    OPENING = "opening",
+    OPEN = "open",
+    CLOSING = "closing",
+    RESETTING = "resetting",
+    ERROR = "error",
+    DESTROYED = "destroyed"
+}
+
 export declare type Infer<T extends ExType<unknown, ExBaseDef, unknown>> = T extends ExType<infer Output, ExBaseDef, unknown> ? Output : never;
 
 declare type IPAddressVersion = 'v4' | 'v6' | 'all';
@@ -3497,12 +3520,12 @@ export declare type OpenOptions<T> = RequireAtLeastOne<DeliveryOptionsBase<T>, '
     onCancel?: () => void;
     /** Called when an error occurs */
     onError?: (error: Error) => void;
-    /** Called when the widget opens */
-    onWidgetOpen?: () => void;
+    /** Called when the importer opens */
+    onImporterOpen?: () => void;
+    /** Called when the importer closes */
+    onImporterClose?: (reason: 'user_close' | 'cancel' | 'complete' | 'error') => void;
     /** Called when the step changes in the wizard */
     onStepChange?: (stepId: ExpressCSVStep, previousStepId?: ExpressCSVStep) => void;
-    /** Called when the widget closes */
-    onWidgetClose?: (reason: 'user_close' | 'cancel' | 'complete' | 'error') => void;
 };
 
 declare type PhoneNumberFormat = 'international' | 'national' | 'both';
@@ -3725,7 +3748,7 @@ export declare type TemplateDownloadOptions<TSchema extends ExType<unknown, ExBa
 
 /**
  * A branded string type for locale entries that require interpolation via `{variable}` syntax.
- * Widget code cannot render a `TemplateString` directly in JSX — it must go through the `t()` function.
+ * Importer code cannot render a `TemplateString` directly in JSX — it must go through the `t()` function.
  * The generic `TVars` encodes the expected variable names so `t()` enforces the correct vars argument.
  */
 declare type TemplateString<TVars extends string = string> = string & {
@@ -3749,9 +3772,9 @@ declare interface URLOptions {
     message?: string;
 }
 
-export declare function useExpressCSV<TSchema extends ExType<unknown, ExBaseDef, unknown>>({ schema, title, importIdentifier, publishableKey, debug, preload, theme, colorMode, customCSS, fonts, stepDisplay, previewSchemaBeforeUpload, templateDownload, saveSession, locale, disableStatusStep, }: UseExpressCSVOptions<TSchema>): {
+export declare function useExpressCSV<TSchema extends ExType<unknown, ExBaseDef, unknown>>({ schema, title, importIdentifier, getSessionToken, debug, preload, theme, colorMode, customCSS, fonts, stepDisplay, previewSchemaBeforeUpload, templateDownload, saveSession, locale, disableStatusStep, }: UseExpressCSVOptions<TSchema>): {
     open: (options: OpenOptions<Infer<TSchema>>) => void;
-    widgetState: WidgetState;
+    importerState: ImporterState;
     isInitialising: boolean;
     isOpen: boolean;
 };
@@ -3760,7 +3783,7 @@ export declare interface UseExpressCSVOptions<TSchema extends ExType<unknown, Ex
     schema: TSchema;
     title?: string;
     importIdentifier: string;
-    publishableKey: string;
+    getSessionToken: () => Promise<string>;
     debug?: boolean;
     preload?: boolean;
     theme?: ECSVTheme;
@@ -3803,34 +3826,11 @@ export declare interface WebhookConfig {
      * Whether to wait for the delivery service to confirm the webhook was
      * successfully received before considering the import complete.
      * When false, the import completes as soon as all chunks are queued.
-     * Default: true
+     * Default: false
      */
     awaitWebhookArrival?: boolean;
 }
 
-/**
- * Widget mode enumeration
- */
-export declare enum WidgetMode {
-    NORMAL = "normal",
-    PRELOAD = "preload"
-}
-
-/**
- * Widget state enumeration for consistent state management
- */
-export declare enum WidgetState {
-    UNINITIALIZED = "uninitialized",
-    INITIALIZING = "initializing",
-    READY = "ready",
-    OPENING = "opening",
-    OPEN = "open",
-    CLOSING = "closing",
-    RESETTING = "resetting",
-    ERROR = "error",
-    DESTROYED = "destroyed"
-}
-
 export declare const x: {
     string: typeof ExString.create;
     number: typeof ExNumber.create;

package/dist/index.d.ts

@@ -2754,7 +2754,7 @@ declare interface ExpressCSVLocale {
         nextDisabledReviewValidating: string;
         nextDisabledReviewInvalid: string;
     };
-    widget: {
+    importer: {
         title: string;
         loading: string;
         closeConfirmTitle: string;
@@ -2763,7 +2763,6 @@ declare interface ExpressCSVLocale {
         closeConfirmContinue: string;
         errorTitle: string;
         startOver: string;
-        invalidPublishableKey: string;
     };
     sessionRecovery: {
         message: string;
@@ -2883,6 +2882,7 @@ declare interface ExpressCSVLocale {
     };
     review: {
         completing: string;
+        processing: string;
         loading: string;
         title: string;
         subtitle: string;
@@ -3475,6 +3475,29 @@ export declare class ImportCancelledError extends Error {
     constructor(message?: string);
 }
 
+/**
+ * Importer preload mode
+ */
+export declare enum ImporterMode {
+    NORMAL = "normal",
+    PRELOAD = "preload"
+}
+
+/**
+ * Importer lifecycle state
+ */
+export declare enum ImporterState {
+    UNINITIALIZED = "uninitialized",
+    INITIALIZING = "initializing",
+    READY = "ready",
+    OPENING = "opening",
+    OPEN = "open",
+    CLOSING = "closing",
+    RESETTING = "resetting",
+    ERROR = "error",
+    DESTROYED = "destroyed"
+}
+
 export declare type Infer<T extends ExType<unknown, ExBaseDef, unknown>> = T extends ExType<infer Output, ExBaseDef, unknown> ? Output : never;
 
 declare type IPAddressVersion = 'v4' | 'v6' | 'all';
@@ -3497,12 +3520,12 @@ export declare type OpenOptions<T> = RequireAtLeastOne<DeliveryOptionsBase<T>, '
     onCancel?: () => void;
     /** Called when an error occurs */
     onError?: (error: Error) => void;
-    /** Called when the widget opens */
-    onWidgetOpen?: () => void;
+    /** Called when the importer opens */
+    onImporterOpen?: () => void;
+    /** Called when the importer closes */
+    onImporterClose?: (reason: 'user_close' | 'cancel' | 'complete' | 'error') => void;
     /** Called when the step changes in the wizard */
     onStepChange?: (stepId: ExpressCSVStep, previousStepId?: ExpressCSVStep) => void;
-    /** Called when the widget closes */
-    onWidgetClose?: (reason: 'user_close' | 'cancel' | 'complete' | 'error') => void;
 };
 
 declare type PhoneNumberFormat = 'international' | 'national' | 'both';
@@ -3725,7 +3748,7 @@ export declare type TemplateDownloadOptions<TSchema extends ExType<unknown, ExBa
 
 /**
  * A branded string type for locale entries that require interpolation via `{variable}` syntax.
- * Widget code cannot render a `TemplateString` directly in JSX — it must go through the `t()` function.
+ * Importer code cannot render a `TemplateString` directly in JSX — it must go through the `t()` function.
  * The generic `TVars` encodes the expected variable names so `t()` enforces the correct vars argument.
  */
 declare type TemplateString<TVars extends string = string> = string & {
@@ -3749,9 +3772,9 @@ declare interface URLOptions {
     message?: string;
 }
 
-export declare function useExpressCSV<TSchema extends ExType<unknown, ExBaseDef, unknown>>({ schema, title, importIdentifier, publishableKey, debug, preload, theme, colorMode, customCSS, fonts, stepDisplay, previewSchemaBeforeUpload, templateDownload, saveSession, locale, disableStatusStep, }: UseExpressCSVOptions<TSchema>): {
+export declare function useExpressCSV<TSchema extends ExType<unknown, ExBaseDef, unknown>>({ schema, title, importIdentifier, getSessionToken, debug, preload, theme, colorMode, customCSS, fonts, stepDisplay, previewSchemaBeforeUpload, templateDownload, saveSession, locale, disableStatusStep, }: UseExpressCSVOptions<TSchema>): {
     open: (options: OpenOptions<Infer<TSchema>>) => void;
-    widgetState: WidgetState;
+    importerState: ImporterState;
     isInitialising: boolean;
     isOpen: boolean;
 };
@@ -3760,7 +3783,7 @@ export declare interface UseExpressCSVOptions<TSchema extends ExType<unknown, Ex
     schema: TSchema;
     title?: string;
     importIdentifier: string;
-    publishableKey: string;
+    getSessionToken: () => Promise<string>;
     debug?: boolean;
     preload?: boolean;
     theme?: ECSVTheme;
@@ -3803,34 +3826,11 @@ export declare interface WebhookConfig {
      * Whether to wait for the delivery service to confirm the webhook was
      * successfully received before considering the import complete.
      * When false, the import completes as soon as all chunks are queued.
-     * Default: true
+     * Default: false
      */
     awaitWebhookArrival?: boolean;
 }
 
-/**
- * Widget mode enumeration
- */
-export declare enum WidgetMode {
-    NORMAL = "normal",
-    PRELOAD = "preload"
-}
-
-/**
- * Widget state enumeration for consistent state management
- */
-export declare enum WidgetState {
-    UNINITIALIZED = "uninitialized",
-    INITIALIZING = "initializing",
-    READY = "ready",
-    OPENING = "opening",
-    OPEN = "open",
-    CLOSING = "closing",
-    RESETTING = "resetting",
-    ERROR = "error",
-    DESTROYED = "destroyed"
-}
-
 export declare const x: {
     string: typeof ExString.create;
     number: typeof ExNumber.create;