@voxket-ai/events-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Shashank Sanket
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,108 @@
+# @voxket-ai/events-sdk
+
+> Embeddable event registration and ticketing widget SDK for Voxket.
+
+## Features
+
+- **Multiple Display Modes**: Popup modal, inline embedded widget, or fullscreen mode.
+- **Shadow DOM Isolation**: Zero CSS conflicts with the host website styles.
+- **Draft Auto-save & Recovery**: Automatically saves user progress and restores previous form entries via `xref_id` or email.
+- **Attendee Portal**: Built-in login, verification code generation/reset, profile editing, and add-on purchasing.
+- **Payment Handling**: External checkout in a dedicated tab with instant status updates.
+- **Framework Agnostic**: Usable via vanilla JavaScript or directly as a React component.
+- **TypeScript Support**: Full type definitions included out of the box.
+
+---
+
+## Installation
+
+```bash
+npm install @voxket-ai/events-sdk
+```
+
+Or via Yarn / pnpm:
+
+```bash
+yarn add @voxket-ai/events-sdk
+# or
+pnpm add @voxket-ai/events-sdk
+```
+
+---
+
+## Quick Start
+
+### 1. Vanilla JavaScript / HTML
+
+```html
+<div id="voxket-widget"></div>
+
+<script type="module">
+  import { EventWidgetClient } from '@voxket-ai/events-sdk';
+
+  const widget = new EventWidgetClient({
+    eventSlug: 'your-event-slug',
+    baseUrl: 'https://api.voxket.com',
+    displayMode: 'popup', // 'popup' | 'widget' | 'fullscreen'
+    theme: {
+      mode: 'custom',
+      primaryColor: '#6366f1'
+    }
+  });
+
+  widget.mount('voxket-widget');
+</script>
+```
+
+### 2. React Applications
+
+```tsx
+import React from 'react';
+import { EventWidget } from '@voxket-ai/events-sdk';
+
+export function EventPage() {
+  return (
+    <EventWidget
+      config={{
+        eventSlug: 'your-event-slug',
+        baseUrl: 'https://api.voxket.com',
+        displayMode: 'widget',
+        theme: {
+          primaryColor: '#2563eb'
+        }
+      }}
+    />
+  );
+}
+```
+
+---
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `eventSlug` | `string` | *(required)* | The unique identifier/slug of your Voxket event. |
+| `baseUrl` | `string` | *(required)* | API base URL for Voxket backend endpoints. |
+| `displayMode` | `'popup' \| 'widget' \| 'fullscreen'` | `'widget'` | Layout display mode for the widget. |
+| `width` | `string` | `undefined` | Custom width (e.g. `'480px'`, `'100%'`). |
+| `height` | `string` | `undefined` | Custom height (e.g. `'600px'`). |
+| `theme.mode` | `'blue' \| 'white' \| 'custom'` | `'blue'` | Preset or custom theme mode. |
+| `theme.primaryColor` | `string` | `undefined` | Custom hex or HSL brand color. |
+| `debug` | `boolean` | `false` | Enable console logging for development. |
+| `onEvent` | `(eventName: string, payload: any) => void` | `undefined` | Callback for widget lifecycle and telemetry events. |
+
+---
+
+## Client Methods (`EventWidgetClient`)
+
+- **`mount(container: HTMLElement | string)`**: Mounts the widget into a DOM container element or ID.
+- **`updateConfig(newConfig: Partial<WidgetConfig>)`**: Updates specific configuration values dynamically without remounting.
+- **`setConfig(newConfig: WidgetConfig)`**: Replaces the full widget configuration.
+- **`unmount()`**: Cleanly destroys the widget and cleans up event listeners and DOM roots.
+
+---
+
+## License
+
+[MIT](LICENSE) © 2025 Shashank Sanket

package/dist/api/ApiClient.d.ts

@@ -0,0 +1,26 @@
+import { Logger } from '../utils/Logger';
+export declare class ApiClient {
+    private baseUrl;
+    private slug;
+    private logger;
+    constructor(baseUrl: string, slug: string, logger: Logger);
+    private fetchApi;
+    getFormSchema(): Promise<any>;
+    submitRegistration(payload: any): Promise<any>;
+    trackProgress(payload: any): Promise<any>;
+    getDraft(xrefId: string): Promise<any>;
+    getDraftByEmail(email: string): Promise<any>;
+    portalLogin(payload: {
+        identifier: string;
+        password: string;
+    }): Promise<any>;
+    portalRequestPasswordReset(identifier: string): Promise<any>;
+    portalConfirmPasswordReset(payload: {
+        identifier: string;
+        code: string;
+        new_password: string;
+    }): Promise<any>;
+    portalGetProfile(token: string): Promise<any>;
+    portalUploadFile(token: string, file: File): Promise<any>;
+    portalUpdateProfile(token: string, payload: any): Promise<any>;
+}

package/dist/components/AttendeePortal.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { ApiClient } from '../api/ApiClient';
+import { StorageHelper } from '../utils/Storage';
+import { Logger } from '../utils/Logger';
+interface AttendeePortalProps {
+    apiClient: ApiClient;
+    storage: StorageHelper;
+    logger: Logger;
+    primaryColor: string;
+    onEvent?: (eventName: string, payload: any) => void;
+}
+export declare const AttendeePortal: React.FC<AttendeePortalProps>;
+export {};

package/dist/components/DynamicForm.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const DynamicForm: ({ schema, onSubmit, onBack, theme, displayMode, isExpanded, onToggleExpand, onClose, onChange, initialValues }: any) => React.JSX.Element;

package/dist/components/EventWidgetReact.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { type WidgetConfig } from '../types';
+interface Props {
+    config: WidgetConfig;
+}
+export declare const EventWidgetReact: React.FC<Props>;
+export {};

package/dist/components/ShadowWrapper.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+export interface ShadowHostWrapperProps {
+    children?: React.ReactNode;
+    useShadow?: boolean;
+}
+export declare const ShadowHostWrapper: React.FC<ShadowHostWrapperProps>;