@expresscsv/sdk 0.1.20 → 0.1.22

package/dist/index.d.mts

@@ -1244,12 +1244,16 @@ export declare class CSVImporter<TSchema extends ExType<unknown, ExBaseDef, unkn
     private debug;
     private importIdentifier;
     private sessionId;
+    private currentSessionToken;
+    private currentSessionTokenExpiresAt;
+    private sessionTokenRefreshTimer;
+    private sessionTokenRefreshPromise;
     private _destroyTimer;
     private _beforeUnloadHandler;
-    private widgetUrl;
+    private importerUrl;
     private appUrl;
-    private widgetState;
-    private widgetMode;
+    private importerState;
+    private importerMode;
     private canRestart;
     private lastError;
     private openOptions;
@@ -1257,6 +1261,7 @@ export declare class CSVImporter<TSchema extends ExType<unknown, ExBaseDef, unkn
     private initCompletePromise;
     private resolveInitComplete;
     private resolvedTemplateDownload;
+    private importerStartupGeneration;
     constructor(options: SDKOptions<TSchema>);
     /**
      * Enhanced state management
@@ -1264,10 +1269,24 @@ export declare class CSVImporter<TSchema extends ExType<unknown, ExBaseDef, unkn
     private setState;
     private updateDerivedState;
     private handleError;
+    private sendImportProgress;
     private waitForEvent;
+    private fetchImporterSessionToken;
+    private updateSessionToken;
+    private clearSessionTokenRefreshTimer;
+    private scheduleSessionTokenRefresh;
+    private ensureActiveSessionToken;
+    private refreshSessionBoundToken;
+    private beginImporterStartup;
+    private cancelImporterStartup;
+    private assertActiveImporterStartup;
+    private withTimeout;
+    private sendSessionDetailsToImporter;
+    private sendStartupErrorToImporter;
+    private bootstrapImporterSession;
     /**
      * Open the import flow with chunk-based data processing.
-     * Automatically opens the widget if not already open.
+     * Automatically opens the importer if not already open.
      *
      * @param options Configuration including onData callback for processing chunks
      */
@@ -1282,11 +1301,6 @@ export declare class CSVImporter<TSchema extends ExType<unknown, ExBaseDef, unkn
      * Chunks data using SDK-determined chunk size (independent of customer's chunkSize)
      */
     private deliverToWebhook;
-    /**
-     * Poll the delivery status endpoint until the delivery reaches a terminal state
-     * ('success' or 'failed'), or until the timeout is exceeded.
-     */
-    private pollDeliveryStatus;
     /**
      * Send a single chunk to backend webhook API with retry logic
      */
@@ -1312,7 +1326,7 @@ export declare class CSVImporter<TSchema extends ExType<unknown, ExBaseDef, unkn
     private removeBeforeUnloadListener;
     private waitForIframeLoad;
     private setupConnectionAndInit;
-    openWidget(options?: {
+    openImporter(options?: {
         reset?: boolean;
     }): Promise<void>;
     /**
@@ -1323,20 +1337,20 @@ export declare class CSVImporter<TSchema extends ExType<unknown, ExBaseDef, unkn
     private createAndAppendIframe;
     private destroy;
     close(reason?: 'user_close' | 'cancel' | 'complete' | 'error'): Promise<void>;
-    private resetWidget;
+    private resetImporter;
     restart(newOptions?: Partial<SDKOptions<TSchema>>): Promise<void>;
-    private handleWidgetClosed;
+    private handleImporterClosed;
     private hideContainer;
     getConnectionStatus(): boolean;
-    getState(): WidgetState;
-    getMode(): WidgetMode;
+    getState(): ImporterState;
+    getMode(): ImporterMode;
     getIsReady(): boolean;
     getIsOpen(): boolean;
     getCanRestart(): boolean;
     getLastError(): Error | null;
     getStatus(): {
-        state: WidgetState;
-        mode: WidgetMode;
+        state: ImporterState;
+        mode: ImporterMode;
         isReady: boolean;
         isOpen: boolean;
         canRestart: boolean;
@@ -2866,7 +2880,7 @@ declare interface ExpressCSVLocale {
         nextDisabledReviewValidating: string;
         nextDisabledReviewInvalid: string;
     };
-    widget: {
+    importer: {
         title: string;
         loading: string;
         closeConfirmTitle: string;
@@ -2875,7 +2889,6 @@ declare interface ExpressCSVLocale {
         closeConfirmContinue: string;
         errorTitle: string;
         startOver: string;
-        invalidPublishableKey: string;
     };
     sessionRecovery: {
         message: string;
@@ -2995,6 +3008,7 @@ declare interface ExpressCSVLocale {
     };
     review: {
         completing: string;
+        processing: string;
         loading: string;
         title: string;
         subtitle: string;
@@ -3587,6 +3601,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;
 
 export declare type InferCSVImporter<TSchema extends ExType<unknown, ExBaseDef, unknown>> = CSVImporter<TSchema>;
@@ -3611,12 +3648,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';
@@ -3765,7 +3802,7 @@ declare type RequireAtLeastOne<T, Keys extends keyof T = keyof T> = Pick<T, Excl
 
 export declare interface SDKOptions<TSchema extends ExType<unknown, ExBaseDef, unknown>> {
     schema: TSchema;
-    publishableKey: string;
+    getSessionToken: () => Promise<string>;
     importIdentifier: string;
     title?: string;
     debug?: boolean;
@@ -3858,7 +3895,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 & {
@@ -3910,34 +3947,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

@@ -1244,12 +1244,16 @@ export declare class CSVImporter<TSchema extends ExType<unknown, ExBaseDef, unkn
     private debug;
     private importIdentifier;
     private sessionId;
+    private currentSessionToken;
+    private currentSessionTokenExpiresAt;
+    private sessionTokenRefreshTimer;
+    private sessionTokenRefreshPromise;
     private _destroyTimer;
     private _beforeUnloadHandler;
-    private widgetUrl;
+    private importerUrl;
     private appUrl;
-    private widgetState;
-    private widgetMode;
+    private importerState;
+    private importerMode;
     private canRestart;
     private lastError;
     private openOptions;
@@ -1257,6 +1261,7 @@ export declare class CSVImporter<TSchema extends ExType<unknown, ExBaseDef, unkn
     private initCompletePromise;
     private resolveInitComplete;
     private resolvedTemplateDownload;
+    private importerStartupGeneration;
     constructor(options: SDKOptions<TSchema>);
     /**
      * Enhanced state management
@@ -1264,10 +1269,24 @@ export declare class CSVImporter<TSchema extends ExType<unknown, ExBaseDef, unkn
     private setState;
     private updateDerivedState;
     private handleError;
+    private sendImportProgress;
     private waitForEvent;
+    private fetchImporterSessionToken;
+    private updateSessionToken;
+    private clearSessionTokenRefreshTimer;
+    private scheduleSessionTokenRefresh;
+    private ensureActiveSessionToken;
+    private refreshSessionBoundToken;
+    private beginImporterStartup;
+    private cancelImporterStartup;
+    private assertActiveImporterStartup;
+    private withTimeout;
+    private sendSessionDetailsToImporter;
+    private sendStartupErrorToImporter;
+    private bootstrapImporterSession;
     /**
      * Open the import flow with chunk-based data processing.
-     * Automatically opens the widget if not already open.
+     * Automatically opens the importer if not already open.
      *
      * @param options Configuration including onData callback for processing chunks
      */
@@ -1282,11 +1301,6 @@ export declare class CSVImporter<TSchema extends ExType<unknown, ExBaseDef, unkn
      * Chunks data using SDK-determined chunk size (independent of customer's chunkSize)
      */
     private deliverToWebhook;
-    /**
-     * Poll the delivery status endpoint until the delivery reaches a terminal state
-     * ('success' or 'failed'), or until the timeout is exceeded.
-     */
-    private pollDeliveryStatus;
     /**
      * Send a single chunk to backend webhook API with retry logic
      */
@@ -1312,7 +1326,7 @@ export declare class CSVImporter<TSchema extends ExType<unknown, ExBaseDef, unkn
     private removeBeforeUnloadListener;
     private waitForIframeLoad;
     private setupConnectionAndInit;
-    openWidget(options?: {
+    openImporter(options?: {
         reset?: boolean;
     }): Promise<void>;
     /**
@@ -1323,20 +1337,20 @@ export declare class CSVImporter<TSchema extends ExType<unknown, ExBaseDef, unkn
     private createAndAppendIframe;
     private destroy;
     close(reason?: 'user_close' | 'cancel' | 'complete' | 'error'): Promise<void>;
-    private resetWidget;
+    private resetImporter;
     restart(newOptions?: Partial<SDKOptions<TSchema>>): Promise<void>;
-    private handleWidgetClosed;
+    private handleImporterClosed;
     private hideContainer;
     getConnectionStatus(): boolean;
-    getState(): WidgetState;
-    getMode(): WidgetMode;
+    getState(): ImporterState;
+    getMode(): ImporterMode;
     getIsReady(): boolean;
     getIsOpen(): boolean;
     getCanRestart(): boolean;
     getLastError(): Error | null;
     getStatus(): {
-        state: WidgetState;
-        mode: WidgetMode;
+        state: ImporterState;
+        mode: ImporterMode;
         isReady: boolean;
         isOpen: boolean;
         canRestart: boolean;
@@ -2866,7 +2880,7 @@ declare interface ExpressCSVLocale {
         nextDisabledReviewValidating: string;
         nextDisabledReviewInvalid: string;
     };
-    widget: {
+    importer: {
         title: string;
         loading: string;
         closeConfirmTitle: string;
@@ -2875,7 +2889,6 @@ declare interface ExpressCSVLocale {
         closeConfirmContinue: string;
         errorTitle: string;
         startOver: string;
-        invalidPublishableKey: string;
     };
     sessionRecovery: {
         message: string;
@@ -2995,6 +3008,7 @@ declare interface ExpressCSVLocale {
     };
     review: {
         completing: string;
+        processing: string;
         loading: string;
         title: string;
         subtitle: string;
@@ -3587,6 +3601,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;
 
 export declare type InferCSVImporter<TSchema extends ExType<unknown, ExBaseDef, unknown>> = CSVImporter<TSchema>;
@@ -3611,12 +3648,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';
@@ -3765,7 +3802,7 @@ declare type RequireAtLeastOne<T, Keys extends keyof T = keyof T> = Pick<T, Excl
 
 export declare interface SDKOptions<TSchema extends ExType<unknown, ExBaseDef, unknown>> {
     schema: TSchema;
-    publishableKey: string;
+    getSessionToken: () => Promise<string>;
     importIdentifier: string;
     title?: string;
     debug?: boolean;
@@ -3858,7 +3895,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 & {
@@ -3910,34 +3947,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;