@voxket-ai/events-sdk 1.0.3 → 1.0.5

package/README.md

@@ -126,6 +126,51 @@ Use `EventWidgetClient` to mount and manage the widget programmatically:
 
 ---
 
+### 3. Abstract Submission Page
+
+Set `isAbstract: true` to render a dedicated abstract page. It uses the same form types and form UI as registration.
+
+- **No Attendee Login tab.** The page shows only the form types.
+- **Review fields are shown.** Fields with `is_review: true` or `false` both appear. Review fields get a card that takes either a file or text, one at a time (**Send text only** / **Send file** toggle).
+- **Review uploads authenticate by email.** They go to `POST /api/portal/{slug}/me/submissions/` with the email entered in the form; no bearer token is sent.
+- **The submit call carries a flag.** The form posts to the registration submit API with `accept_review_file: true`, and draft saves send the same flag.
+- **After submitting:** a "Submitted" screen with a **Submit Again** button. There is no payment step.
+
+**React**
+
+```tsx
+<EventWidget
+  config={{
+    eventSlug: 'fogsi-yuva_2026',
+    baseUrl: 'https://api.voxket.com',
+    displayMode: 'widget', // full-page
+    isAbstract: true,
+    theme: { primaryColor: '#c026d3' },
+    onEvent: (name, payload) => console.log(name, payload),
+    onError: (err) => console.error(err.message),
+  }}
+/>
+```
+
+**Vanilla JS**
+
+```js
+const client = new EventWidgetClient({
+  eventSlug: 'fogsi-yuva_2026',
+  baseUrl: 'https://api.voxket.com',
+  displayMode: 'fullscreen',
+  isAbstract: true,
+});
+client.mount('voxket-widget-container');
+
+// Switch an existing widget between registration and abstract
+// client.updateConfig({ isAbstract: false });
+```
+
+To host both pages, render one widget per page (or route) and set `isAbstract` on the abstract one only.
+
+---
+
 ## Configuration Reference (`WidgetConfig`)
 
 All available options for the `WidgetConfig` object:
@@ -141,6 +186,9 @@ All available options for the `WidgetConfig` object:
 | `theme.primaryColor` | `string` | `'#2563eb'` | Brand color used for primary buttons, tabs, highlights, and headers. |
 | `theme.fontFamily` | `string` | System font | Custom font family CSS string (e.g. `'Inter, sans-serif'`). |
 | `theme.mode` | `'light' \| 'dark' \| 'blue' \| 'white' \| 'custom'` | `'light'` | Preset theme mode alias. |
+| `isAbstract` | `boolean` | `false` | Abstract submission page: no attendee login, shows `is_review` fields, adds `accept_review_file: true` on submit. See [Abstract Submission Page](#3-abstract-submission-page). |
+| `headerBannerImage` | `string` | `undefined` | Banner image on the right of the top header, scaled to the header's height; its left edge fades into the header's theme-color gradient. See [Banner & Background Images](#banner--background-images). |
+| `backgroundImage` | `string` | `undefined` | Faded background image behind the form-types list, the form page and the attendee login/portal. It stays still while content scrolls. See [Banner & Background Images](#banner--background-images). |
 | `width` | `string` | `undefined` | Custom width override (e.g. `'500px'`, `'100%'`). |
 | `height` | `string` | `undefined` | Custom height override (e.g. `'700px'`, `'650px'`). |
 | `timeoutMs` | `number` | `120000` *(2 min)* | Network request timeout in milliseconds before triggering `onError`. |
@@ -150,6 +198,18 @@ All available options for the `WidgetConfig` object:
 | `onError` | `(error: WidgetErrorPayload) => void` | `undefined` | Callback fired on validation, submission, network, or schema load errors. |
 | `onEvent` | `(eventName: string, payload: any) => void` | `undefined` | Optional generic event bus for internal widget lifecycle events. |
 
+**Common `onEvent` names:**
+
+| Event | When it fires |
+| :--- | :--- |
+| `form_loaded` | The form schema has loaded. |
+| `draft_saved` | Form progress was auto-saved. |
+| `submitted` | The form was submitted (registration or abstract). |
+| `review_submission_uploaded` | A review field was submitted from the abstract page. |
+| `portal_submission_uploaded` | A review field was submitted from the attendee portal. |
+| `portal_file_deleted` | The attendee deleted an uploaded file in the portal. |
+| `attendee_profile_loaded` | The attendee portal profile has loaded. |
+
 ---
 
 ## Event Callbacks & Toast Notifications
@@ -252,6 +312,29 @@ const config: WidgetConfig = {
 
 ---
 
+## Banner & Background Images
+
+```typescript
+const config: WidgetConfig = {
+  eventSlug: 'fogsi-yuva_2026',
+  baseUrl: 'https://api.voxket.com',
+  theme: { primaryColor: '#c026d3' },
+  headerBannerImage: 'https://i.postimg.cc/Hk02BDTh/image.png',
+  backgroundImage: 'https://i.postimg.cc/DZmb4dtH/Screenshot-2026-09-24-200659.png',
+};
+```
+
+| Prop | Where it shows | Behaviour |
+| :--- | :--- | :--- |
+| `headerBannerImage` | Right side of the top header, on every view (registration, attendee login, abstract) | Scaled to the header's height and never makes the header taller. Its left edge fades into the header gradient. Uses at most 65% of the header width; on narrow screens the image is cropped from the left. |
+| `backgroundImage` | Behind the form-types list, the form page and the attendee login/portal | Covered by a page-colored overlay so content stays readable; the overlay follows `themeMode` (light or dark). Stays still while content scrolls. Cards and form inputs keep their normal colors. |
+
+- The header always uses a theme-color gradient, whether or not a banner is set.
+- The tabs row is not affected by either image; it keeps the light/dark theme color.
+- Both images are optional. Leave them out for a plain gradient header and a solid page background.
+
+---
+
 ## Client API Methods (`EventWidgetClient`)
 
 When using the vanilla JavaScript / non-React API:

package/dist/components/AttendeePortal.d.ts

@@ -8,7 +8,6 @@ interface AttendeePortalProps {
     logger: Logger;
     primaryColor: string;
     isDark?: boolean;
-    backgroundImage?: string;
     isWidgetPage?: boolean;
     onEvent?: (eventName: string, payload: any) => void;
     onError?: (error: any) => void;

package/dist/components/DynamicForm.d.ts

@@ -1,2 +1,2 @@
 import React from 'react';
-export declare const DynamicForm: ({ schema, onSubmit, onBack, theme, displayMode, isExpanded, onToggleExpand, onClose, onChange, initialValues, isDark, apiClient, storage, onError, onEvent, backgroundImage, ticketType, showReviewFields, }: any) => React.JSX.Element;
+export declare const DynamicForm: ({ schema, onSubmit, onBack, theme, displayMode, isExpanded, onToggleExpand, onClose, onChange, initialValues, isDark, apiClient, storage, onError, onEvent, backgroundStyle, ticketType, showReviewFields, }: any) => React.JSX.Element;

package/dist/components/EventWidgetReact.d.ts

@@ -1,60 +1,5 @@
 import React from 'react';
 import { type WidgetConfig, type WidgetPosition } from '../types';
-export declare const FALLBACK_FORM_TYPES: {
-    id: number;
-    type: string;
-    name: string;
-    category: string;
-    price: number;
-    currency: string;
-    tax_info: string;
-    description: string;
-    perks: string[];
-    seats_left: string;
-    valid_till: string;
-    form_schema: {
-        title: string;
-        review_fields: {
-            id: string;
-            submission: {
-                reviewer: string;
-            };
-        }[];
-        fields: ({
-            id: string;
-            label: string;
-            type: string;
-            options: string[];
-            required: boolean;
-            placeholder?: undefined;
-            description?: undefined;
-        } | {
-            id: string;
-            label: string;
-            type: string;
-            required: boolean;
-            placeholder: string;
-            options?: undefined;
-            description?: undefined;
-        } | {
-            id: string;
-            label: string;
-            type: string;
-            required: boolean;
-            placeholder: string;
-            description: string;
-            options?: undefined;
-        } | {
-            id: string;
-            label: string;
-            type: string;
-            required: boolean;
-            description: string;
-            options?: undefined;
-            placeholder?: undefined;
-        })[];
-    };
-}[];
 export type Corner = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
 export declare function normalizePosition(pos?: WidgetPosition): Corner;
 export declare const getCornerStyle: (corner: Corner) => React.CSSProperties;