@dolard.eu/versiq-widget 0.1.0

package/dist/postmessage.d.ts

@@ -0,0 +1,47 @@
+/**
+ * postMessage Protocol
+ *
+ * Handles secure bidirectional communication between the parent page
+ * and the widget iframe using the postMessage API.
+ */
+import type { WidgetCommand, WidgetEvent } from "./types";
+/**
+ * Validate that a message origin is trusted.
+ */
+export declare function isValidOrigin(origin: string, allowedOrigins: string[]): boolean;
+/**
+ * Check if an event contains a valid Versiq message.
+ */
+export declare function isVersiqMessage(event: MessageEvent): event is MessageEvent<WidgetCommand | WidgetEvent>;
+/**
+ * Send a command to the widget iframe.
+ */
+export declare function sendCommand(iframe: HTMLIFrameElement, command: WidgetCommand, targetOrigin: string): void;
+/**
+ * Send an event to the parent window.
+ * Used by the embedded widget to notify the parent of state changes.
+ */
+export declare function sendEvent(event: WidgetEvent, targetOrigin: string): void;
+export interface MessageListenerOptions {
+    /** Allowed origins for incoming messages */
+    allowedOrigins?: string[];
+    /** Callback for received messages */
+    onMessage: (message: WidgetCommand | WidgetEvent, origin: string) => void;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Only accept messages from this window (for multi-instance isolation) */
+    sourceWindow?: Window | null;
+}
+/**
+ * Create a message listener with origin validation.
+ * Returns a cleanup function to remove the listener.
+ */
+export declare function createMessageListener(options: MessageListenerOptions): () => void;
+/**
+ * Encode theme config for URL parameter.
+ */
+export declare function encodeTheme(theme: object): string;
+/**
+ * Decode theme config from URL parameter.
+ */
+export declare function decodeTheme<T>(encoded: string): T | null;

package/dist/types.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Widget SDK Types
+ *
+ * Cross-workspace contracts (viewport, theme, widget config, application
+ * config, postMessage protocol) now live in `@dolard.eu/versiq-core-types` — this file
+ * re-exports them so existing consumers (`apps/marketing`,
+ * `apps/app/src/components/portal/sandbox`) keep working unchanged. The only
+ * types still defined locally are widget-specific SDK surfaces (B2B profile
+ * schemas, `VersiqAPI`, `window` augmentation).
+ */
+import { z } from "zod";
+import type { ColorScheme, ThemeConfig, WidgetEventHandler, WidgetEventType } from "@dolard.eu/versiq-core-types";
+export { applicationConfigResponseSchema, breakpointsConfigSchema, MESSAGE_TYPES, messageRoleSchema, resolveTheme, responsiveConfigSchema, themeConfigSchema, viewportModeSchema, widgetConfigSchema, widgetMessageSchema, widgetPositionSchema, } from "@dolard.eu/versiq-core-types";
+export type { ApplicationConfigResponse, BreakpointsConfig, ColorScheme, MessageRole, MessageType, ResolvedTheme, ResponsiveConfig, ThemeConfig, ThemeDefaults, ViewportMode, WidgetCommand, WidgetConfig, WidgetEvent, WidgetEventHandler, WidgetEventType, WidgetMessage, WidgetPosition, WidgetProfile, } from "@dolard.eu/versiq-core-types";
+/**
+ * User type enum.
+ */
+export declare const b2bUserTypeSchema: z.ZodEnum<{
+    prospect: "prospect";
+    partner: "partner";
+    unknown: "unknown";
+}>;
+/**
+ * Business sector enum.
+ */
+export declare const b2bSectorSchema: z.ZodEnum<{
+    ecommerce: "ecommerce";
+    "real-estate": "real-estate";
+    automotive: "automotive";
+    travel: "travel";
+    recruitment: "recruitment";
+    other: "other";
+}>;
+/**
+ * Company size enum.
+ */
+export declare const b2bCompanySizeSchema: z.ZodEnum<{
+    startup: "startup";
+    pme: "pme";
+    eti: "eti";
+    "grand-groupe": "grand-groupe";
+}>;
+/**
+ * Monthly traffic enum.
+ */
+export declare const b2bMonthlyTrafficSchema: z.ZodEnum<{
+    "< 10k": "< 10k";
+    "10k-50k": "10k-50k";
+    "50k-200k": "50k-200k";
+    "> 200k": "> 200k";
+}>;
+/**
+ * Business objectives enum.
+ */
+export declare const b2bObjectiveSchema: z.ZodEnum<{
+    other: "other";
+    "lead-qualification": "lead-qualification";
+    personalization: "personalization";
+    "cart-abandonment": "cart-abandonment";
+    conversion: "conversion";
+}>;
+/**
+ * E-commerce platform enum.
+ */
+export declare const b2bPlatformSchema: z.ZodEnum<{
+    shopify: "shopify";
+    woocommerce: "woocommerce";
+    prestashop: "prestashop";
+    custom: "custom";
+    none: "none";
+}>;
+/**
+ * Implementation timeline enum.
+ */
+export declare const b2bTimelineSchema: z.ZodEnum<{
+    immediate: "immediate";
+    "1-month": "1-month";
+    "3-months": "3-months";
+    exploring: "exploring";
+}>;
+/**
+ * Budget range enum.
+ */
+export declare const b2bBudgetRangeSchema: z.ZodEnum<{
+    "< 500": "< 500";
+    "500-2000": "500-2000";
+    "2000-5000": "2000-5000";
+    "> 5000": "> 5000";
+}>;
+/**
+ * B2B qualification profile schema.
+ */
+export declare const b2bProfileSchema: z.ZodObject<{
+    userType: z.ZodOptional<z.ZodEnum<{
+        prospect: "prospect";
+        partner: "partner";
+        unknown: "unknown";
+    }>>;
+    sector: z.ZodOptional<z.ZodEnum<{
+        ecommerce: "ecommerce";
+        "real-estate": "real-estate";
+        automotive: "automotive";
+        travel: "travel";
+        recruitment: "recruitment";
+        other: "other";
+    }>>;
+    companySize: z.ZodOptional<z.ZodEnum<{
+        startup: "startup";
+        pme: "pme";
+        eti: "eti";
+        "grand-groupe": "grand-groupe";
+    }>>;
+    monthlyTraffic: z.ZodOptional<z.ZodEnum<{
+        "< 10k": "< 10k";
+        "10k-50k": "10k-50k";
+        "50k-200k": "50k-200k";
+        "> 200k": "> 200k";
+    }>>;
+    objectives: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        other: "other";
+        "lead-qualification": "lead-qualification";
+        personalization: "personalization";
+        "cart-abandonment": "cart-abandonment";
+        conversion: "conversion";
+    }>>>;
+    platform: z.ZodOptional<z.ZodEnum<{
+        shopify: "shopify";
+        woocommerce: "woocommerce";
+        prestashop: "prestashop";
+        custom: "custom";
+        none: "none";
+    }>>;
+    timeline: z.ZodOptional<z.ZodEnum<{
+        immediate: "immediate";
+        "1-month": "1-month";
+        "3-months": "3-months";
+        exploring: "exploring";
+    }>>;
+    budgetRange: z.ZodOptional<z.ZodEnum<{
+        "< 500": "< 500";
+        "500-2000": "500-2000";
+        "2000-5000": "2000-5000";
+        "> 5000": "> 5000";
+    }>>;
+}, z.core.$strip>;
+export type B2BProfile = z.infer<typeof b2bProfileSchema>;
+/**
+ * Public API exposed on window.Versiq.
+ */
+export interface VersiqAPI {
+    /** Application ID (available after config resolution) */
+    readonly applicationId: string;
+    /** Open the widget */
+    open(): void;
+    /** Close the widget */
+    close(): void;
+    /** Reset the conversation */
+    reset(): void;
+    /** Update theme dynamically */
+    setTheme(theme: ThemeConfig): void;
+    /**
+     * Update only the color scheme. Sugar over setTheme({ colorScheme }) so
+     * integrators can wire their own dark-mode toggle without rebuilding the
+     * full theme object: `window.Versiq.setColorScheme("dark")`.
+     */
+    setColorScheme(scheme: ColorScheme): void;
+    /** Identify the current user with host-attested HMAC verification */
+    identify(params: {
+        email: string;
+        userId?: string;
+        userHash: string;
+    }): void;
+    /** Subscribe to events */
+    on<T = unknown>(event: WidgetEventType, handler: WidgetEventHandler<T>): void;
+    /** Unsubscribe from events */
+    off<T = unknown>(event: WidgetEventType, handler: WidgetEventHandler<T>): void;
+    /** Widget version */
+    version: string;
+}
+declare global {
+    interface Window {
+        Versiq?: VersiqAPI;
+        VersiqApps?: Map<string, VersiqAPI>;
+    }
+}