dexie-cloud-addon 4.3.0 → 4.3.3

package/dist/modern/types/DXCUserInteraction.d.ts

@@ -1,7 +1,29 @@
-import { OAuthProviderInfo } from 'dexie-cloud-common';
 import { DXCAlert } from './DXCAlert';
 import { DXCInputField } from './DXCInputField';
-export type DXCUserInteraction = DXCGenericUserInteraction | DXCEmailPrompt | DXCOTPPrompt | DXCMessageAlert | DXCLogoutConfirmation | DXCProviderSelection;
+export type DXCUserInteraction = DXCGenericUserInteraction | DXCEmailPrompt | DXCOTPPrompt | DXCMessageAlert | DXCLogoutConfirmation;
+/** A selectable option that can appear in any user interaction.
+ *
+ * Similar to an HTML `<option>` element:
+ * - `name` identifies the field name in the result (like input name attribute)
+ * - `value` is the value to return when selected (like option value attribute)
+ * - `displayName` is the human-readable label
+ *
+ * When an option is selected, call `onSubmit({ [option.name]: option.value })`.
+ */
+export interface DXCOption {
+    /** Field name for the result (like HTML input name attribute) */
+    name: string;
+    /** Value to return when selected (like HTML option value attribute) */
+    value: string;
+    /** Human-readable display label */
+    displayName: string;
+    /** URL to an icon image (mutually exclusive with iconSvg) */
+    iconUrl?: string;
+    /** Inline SVG markup for the icon (mutually exclusive with iconUrl) */
+    iconSvg?: string;
+    /** Optional style hint for the UI (e.g., 'google', 'github', 'microsoft', 'apple', 'otp') */
+    styleHint?: string;
+}
 export interface DXCGenericUserInteraction<Type extends string = "generic", TFields extends {
     [name: string]: DXCInputField;
 } = any> {
@@ -9,6 +31,10 @@ export interface DXCGenericUserInteraction<Type extends string = "generic", TFie
     title: string;
     alerts: DXCAlert[];
     fields: TFields;
+    /** Optional selectable options. When present, render as clickable buttons.
+     * When user clicks an option, call `onSubmit({ [option.name]: option.value })`.
+     */
+    options?: DXCOption[];
     submitLabel: string;
     cancelLabel: string | null;
     onSubmit: (params: {
@@ -18,7 +44,9 @@ export interface DXCGenericUserInteraction<Type extends string = "generic", TFie
 }
 /** When the system needs to prompt for an email address for login.
  *
-*/
+ * May include `options` when social login providers are available.
+ * Options should be rendered as clickable buttons above the email field.
+ */
 export interface DXCEmailPrompt {
     type: 'email';
     title: string;
@@ -29,6 +57,8 @@ export interface DXCEmailPrompt {
             placeholder: string;
         };
     };
+    /** Optional OAuth provider options. Render as clickable buttons. */
+    options?: DXCOption[];
     submitLabel: string;
     cancelLabel: string;
     onSubmit: (params: {
@@ -92,25 +122,3 @@ export interface DXCLogoutConfirmation {
     }) => void;
     onCancel: () => void;
 }
-/** When the system needs user to select a login method (OAuth provider or OTP).
- * Emitted when the server has OAuth providers configured and enabled.
- */
-export interface DXCProviderSelection {
-    type: 'provider-selection';
-    title: string;
-    alerts: DXCAlert[];
-    /** Available OAuth providers */
-    providers: OAuthProviderInfo[];
-    /** Whether email/OTP option is available */
-    otpEnabled: boolean;
-    /** Empty - no text fields for this interaction type */
-    fields: {};
-    /** No submit button - provider buttons instead */
-    submitLabel?: undefined;
-    cancelLabel: string;
-    /** Called when user selects an OAuth provider */
-    onSelectProvider: (providerName: string) => void;
-    /** Called when user chooses email/OTP instead */
-    onSelectOtp: () => void;
-    onCancel: () => void;
-}