@simula/ads 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Simula
+
+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,406 @@
+# Simula Ad SDK
+
+**React SDK for AI-Powered Contextual Ads**
+
+Simula delivers **contextually relevant ads** for conversational AI apps and LLM-based interfaces. It’s lightweight, easy to integrate, and MRC-compliant out of the box.
+
+---
+
+## 🚀 Installation
+
+```bash
+npm install @simula/ads
+```
+
+---
+
+## ⚡ Quick Start
+
+Integrate in **two steps**:
+
+1. **Wrap your chat/conversation component** with `SimulaProvider`
+2. **Insert** `<InChatAdSlot />` where you want ads
+
+```tsx
+import { SimulaProvider, InChatAdSlot } from "@simula/ads";
+
+function App() {
+  return (
+    <div>
+      <Header />
+      <ChatInterface />  {/* SimulaProvider wraps individual conversations */}
+    </div>
+  );
+}
+
+function ChatInterface() {
+  const [messages, setMessages] = useState([]);
+
+  return (
+    <SimulaProvider apiKey="SIMULA_xxx">
+      <div>
+        {messages.map((msg, i) => (
+          <div key={i}>
+            <p><strong>{msg.role}:</strong> {msg.content}</p>
+            {msg.role === "assistant" && (
+              <InChatAdSlot
+                messages={messages.slice(0, i + 1)}
+                formats="all"
+                theme={{ theme: "light", accent: "blue" }}
+              />
+            )}
+          </div>
+        ))}
+      </div>
+    </SimulaProvider>
+  );
+}
+```
+
+---
+
+## 🧩 Components
+
+### `SimulaProvider`
+
+Initializes the SDK and manages session state.
+
+| Prop            | Type        | Required | Default | Description                                                                                                      |
+| --------------- | ----------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------- |
+| `apiKey`        | `string`    | ✅        | —       | Your Simula API key from the [dashboard](https://simula.ad)                                                      |
+| `children`      | `ReactNode` | ✅        | —       | Your app components                                                                                              |
+| `devMode`       | `boolean`   | ❌        | `false` | Enables development mode                                                                                         |
+| `primaryUserID` | `string`    | ❌        | —       | Publisher-provided user identifier. **Recommended** for consistent tracking across devices and sessions.         |
+
+```tsx
+// Wrap individual chat/conversation components
+function ChatInterface({ conversationId }) {
+  const [messages, setMessages] = useState([]);
+
+  return (
+    <SimulaProvider apiKey="SIMULA_xxx">
+      {/* Your chat UI */}
+    </SimulaProvider>
+  );
+}
+
+// For authenticated apps with user tracking (recommended)
+function ChatInterface({ conversationId, userId }) {
+  const [messages, setMessages] = useState([]);
+
+  return (
+    <SimulaProvider apiKey="SIMULA_xxx" primaryUserID={userId}>
+      {/* Your chat UI */}
+    </SimulaProvider>
+  );
+}
+```
+
+> **Provider Best Practices**
+>
+> * **Wrap individual conversations** – Place `SimulaProvider` around each chat or character component so that each conversation is treated as a separate session. This provides better ad targeting based on conversation context.
+>
+> * **Provide `primaryUserID`** – Use your user's ID to enable cross-device tracking and cookie-independent identification. This approach delivers:
+>   * **Higher CPMs** – Better user attribution leads to more valuable ad placements
+>   * **Frequency capping** – Prevents oversending ads to the same user
+>   * **Better ad experience** – Optimized targeting based on consistent user history
+>   * **Accurate analytics** – Reliable performance metrics across devices and sessions
+>
+> * **One provider per conversation** – Don't nest multiple `SimulaProvider` instances. Each conversation/chat component should have its own provider at the top level.
+>
+> For anonymous users, you can still use `SimulaProvider` without `primaryUserID`, but tracking will rely on cookies.
+
+---
+
+### `InChatAdSlot`
+
+Displays an ad based on conversation context.
+
+| Prop           | Type                   | Required | Default                                                                                              | Description                                                                                                                                                                     |
+| -------------- | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `messages`     | `Message[]`            | ✅        | —                                                                                                    | Array of `{ role, content }`; pass recent conversation (e.g. last 6 turns).                                                                                                     |
+| `trigger`      | `Promise<any>`         | ❌        | Fires immediately on viewability                                                                     | Promise to await before fetching the ad (e.g. LLM call).                                                                                                                        |
+| `formats`      | `string \| string[]`   | ❌        | `['all']`                                                                                            | Preferred ad formats: `'all'`, `'tips'`, `'interactive'`, `'suggestions'`, `'text'`, `'highlight'`, `'visual_banner'`, `'image_feature'`, or an array like `['text', 'highlight']`. See [Appendix: Ad Formats](#appendix-ad-formats) for visual examples.<br>**A/B Testing:** Pass an array to automatically A/B test different formats and let Simula pick the best over time. |
+| `theme`        | `SimulaTheme`          | ❌        | `{ theme: 'auto', width: 'auto', accent: ['neutral','image'], font: 'sans-serif', cornerRadius: 8 }` | Customize ad appearance (see Theme Options). Arrays trigger A/B testing.                                                                                                        |
+| `charDesc`     | `string`               | ❌        | `undefined`                                                                                          | Character description for additional context to improve ad targeting.                                                                                                           |
+| `debounceMs`   | `number`               | ❌        | `0`                                                                                                  | Delay in milliseconds before fetching.                                                                                                                                          |
+| `onImpression` | `(ad: AdData) => void` | ❌        | `undefined`                                                                                          | Callback when ad is viewable (50% visible for ≥1s).                                                                                                                             |
+| `onClick`      | `(ad: AdData) => void` | ❌        | `undefined`                                                                                          | Callback when ad is clicked.                                                                                                                                                    |
+| `onError`      | `(err: Error) => void` | ❌        | `undefined`                                                                                          | Callback when ad fails or no-fill occurs.                                                                                                                                       |
+
+**Behavior:**
+
+* Fetches **once** per slot (static)
+* Triggers on **viewport visibility** (50% visible)
+* Includes built-in **bot protection**
+* Tracks impressions **MRC-compliantly**
+
+---
+
+## 🎨 Theme Options
+
+```ts
+interface SimulaTheme {
+  theme?: "light" | "dark" | "auto";         // default: "auto"
+  accent?: AccentOption | AccentOption[];   // default: ["neutral", "image"] (A/B tested)
+  font?: FontOption | FontOption[];         // default: "sans-serif"
+  width?: number | string;                  // default: "auto" (min 320px)
+  cornerRadius?: number;                    // default: 8
+}
+```
+
+**Modes:** `light` | `dark` | `auto`
+**Accents:**
+`blue`, `red`, `green`, `yellow`, `purple`, `pink`, `orange`, `neutral`, `gray`, `tan`, `transparent`, `image`
+**Fonts:** `sans-serif`, `serif`, `monospace`
+
+> **Height:** fixed at **265px**
+> **Width:** min **320px**, accepts px/%, or `auto`
+
+> **A/B Testing:**
+> When you pass an **array** (e.g., `accent: ['blue', 'green', 'purple']`), Simula will **automatically A/B test** across the provided options—colors, fonts, or formats—and **optimize over time for the best-performing variant**.
+
+```tsx
+// Default theme (auto)
+<InChatAdSlot messages={messages} />
+
+// Light theme
+<InChatAdSlot messages={messages} theme={{ theme: "light", accent: "blue" }} />
+
+// Dark theme with custom width
+<InChatAdSlot
+  messages={messages}
+  theme={{ theme: "dark", accent: "purple", width: 600, cornerRadius: 12 }}
+/>
+
+// A/B testing
+<InChatAdSlot
+  messages={messages}
+  theme={{
+    accent: ["blue", "green", "purple"],     // A/B test colors
+    font: ["sans-serif", "serif"],           // A/B test fonts
+    width: "100%"
+  }}
+/>
+```
+
+---
+
+## 💬 Integration Example
+
+### Chat App with OpenAI
+
+```tsx
+import { useState } from "react";
+import { SimulaProvider, InChatAdSlot } from "@simula/ads";
+import OpenAI from "openai";
+
+const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+
+export default function App() {
+  return (
+    <div>
+      <Header />
+      <ChatApp />  {/* Each conversation has its own SimulaProvider */}
+    </div>
+  );
+}
+
+function ChatApp() {
+  const [messages, setMessages] = useState([]);
+  const [input, setInput] = useState("");
+  const [loading, setLoading] = useState(false);
+
+  async function sendMessage() {
+    if (!input.trim()) return;
+
+    const userMessage = { role: "user", content: input.trim() };
+    const newMessages = [...messages, userMessage];
+    setMessages(newMessages);
+    setInput("");
+    setLoading(true);
+
+    try {
+      const llmPromise = client.chat.completions.create({
+        model: "gpt-4o-mini",
+        messages: newMessages,
+      });
+
+      const res = await llmPromise;
+      const reply = res.choices[0].message;
+
+      setMessages((prev) => [...prev, { ...reply, llmPromise }]);
+    } finally {
+      setLoading(false);
+    }
+  }
+
+  return (
+    <SimulaProvider apiKey="SIMULA_xxx">
+      <div className="chat">
+        {messages.map((msg, i) => (
+          <div key={i}>
+            <p><strong>{msg.role}:</strong> {msg.content}</p>
+
+            {msg.role === "assistant" && (
+              <InChatAdSlot
+                key={`adslot-${i}`}              // ✅ Required if rendering in a list
+                trigger={msg.llmPromise}         // default: fires immediately if not provided
+                messages={messages.slice(0, i + 1)}
+                formats="all"
+                theme={{ theme: "light", accent: "blue", width: "auto" }}
+              />
+            )}
+          </div>
+        ))}
+
+        <input
+          value={input}
+          onChange={(e) => setInput(e.target.value)}
+          onKeyDown={(e) => e.key === "Enter" && sendMessage()}
+        />
+        <button onClick={sendMessage} disabled={loading}>Send</button>
+      </div>
+    </SimulaProvider>
+  );
+}
+```
+
+> **Tips:**
+>
+> * **Wrap `SimulaProvider` around the chat component** – This treats each conversation as a separate session for better ad targeting.
+> * Use `key` prop when `<InChatAdSlot />` is rendered inside a list or dynamic loop.
+> * The `trigger` prop waits for the LLM response before fetching ads. If omitted, the ad fetches immediately when viewable.
+
+---
+
+## 🔑 Features
+
+* **Contextual Targeting** – AI-powered ad matching to conversation content
+* **Bot Protection** – via [@fingerprintjs/botd](https://github.com/fingerprintjs/botd)
+* **MRC-Compliant Viewability** – 50% visible for ≥1s
+* **Responsive** – Flexible widths with enforced minimums
+* **Static Fetch** – Each slot fetches once and stays fixed
+* **Session Management** – Automatic
+* **Robust Error Handling** – Graceful degradation & callbacks
+* **TypeScript Support** – Built-in type definitions
+* **Built-in A/B Testing** – Test multiple colors, formats, or fonts by passing arrays and let Simula optimize performance over time
+
+---
+
+## ⚙️ Advanced Usage
+
+### Event Handlers
+
+```tsx
+<InChatAdSlot
+  messages={messages}
+  onImpression={(ad) => console.log("Impression:", ad.id)}  // default: none
+  onClick={(ad) => console.log("Clicked:", ad.id)}          // default: none
+  onError={(err) => console.error("Ad error:", err)}        // default: none
+/>
+```
+
+### Debounce Fetching
+
+```tsx
+<InChatAdSlot
+  messages={messages}
+  debounceMs={500}   // default: 0
+/>
+```
+
+---
+
+## 📦 TypeScript Types
+
+```ts
+import type {
+  SimulaTheme,
+  Message,
+  AdData,
+  InChatAdSlotProps,
+  SimulaProviderProps
+} from "@simula/ads";
+```
+
+---
+
+## 📚 Resources
+
+* [Website](https://simula.ad)
+* [GitHub Issues](https://github.com/Simula-AI-SDK/simula-ad-sdk/issues)
+* Support: **[admin@simula.ad](mailto:admin@simula.ad)**
+
+---
+
+## 📄 License
+
+MIT
+
+---
+
+## 📑 Appendix: Ad Formats
+
+Visual examples of all available ad formats across mobile and desktop:
+
+| Format | Mobile | Desktop |
+|--------|--------|---------|
+| **tips** | <img src="./assets/tips_mobile.png" width="200" alt="Tips format on mobile" /> | <img src="./assets/tips_desktop.png" width="400" alt="Tips format on desktop" /> |
+| **interactive** | <img src="./assets/interactive_mobile.png" width="200" alt="Interactive format on mobile" /> | <img src="./assets/interactive_desktop.png" width="400" alt="Interactive format on desktop" /> |
+| **suggestions** | <img src="./assets/suggestions_mobile.png" width="200" alt="Suggestions format on mobile" /> | <img src="./assets/suggestions_desktop.png" width="400" alt="Suggestions format on desktop" /> |
+| **text** | <img src="./assets/text_mobile.png" width="200" alt="Text format on mobile" /> | <img src="./assets/text_desktop.png" width="400" alt="Text format on desktop" /> |
+| **highlight** | <img src="./assets/highlight_mobile.png" width="200" alt="Highlight format on mobile" /> | <img src="./assets/highlight_desktop.png" width="400" alt="Highlight format on desktop" /> |
+| **visual_banner** | <img src="./assets/visual_banner_mobile.png" width="200" alt="Visual banner format on mobile" /> | <img src="./assets/visual_banner_desktop.png" width="400" alt="Visual banner format on desktop" /> |
+| **image_feature** | <img src="./assets/image_feature_mobile.png" width="200" alt="Image feature format on mobile" /> | <img src="./assets/image_feature_desktop.png" width="400" alt="Image feature format on desktop" /> |
+
+> **Note:** The `'all'` format allows Simula to automatically select the best format based on context and performance.
+
+---
+
+## 📑 Appendix: Invalid Format & Accent Combinations
+
+Certain ad formats have restrictions on which accent colors can be used. **These restrictions only apply when you specify an invalid combination with no other valid options.** When A/B testing with arrays, Simula automatically selects valid combinations from the available options.
+
+| Format | Allowed Accents | Restrictions |
+|--------|----------------|--------------|
+| **interactive** | All colors, `'image'`, `'neutral'`, `'gray'`, `'tan'` | ❌ Cannot use `'transparent'` |
+| **tips** | All colors, `'image'`, `'neutral'`, `'gray'`, `'tan'` | ❌ Cannot use `'transparent'` |
+| **text** | **Only** `'transparent'` | ❌ Cannot use colors or `'image'` |
+| **highlight** | All colors, `'image'`, `'neutral'`, `'gray'`, `'tan'` | ❌ Cannot use `'transparent'` |
+| **visual_banner** | All colors, `'neutral'`, `'gray'`, `'tan'` | ❌ Cannot use `'image'` or `'transparent'` |
+| **image_feature** | All colors, `'neutral'`, `'gray'`, `'tan'` | ❌ Cannot use `'image'` or `'transparent'` |
+| **suggestions** | All accents allowed | ✅ No restrictions |
+
+**Color accents:** `'blue'`, `'red'`, `'green'`, `'yellow'`, `'purple'`, `'pink'`, `'orange'`, `'neutral'`, `'gray'`, `'tan'`
+
+### Examples
+
+```tsx
+// ✅ Valid - single format, single accent
+<InChatAdSlot formats="interactive" theme={{ accent: "blue" }} />
+<InChatAdSlot formats="text" theme={{ accent: "transparent" }} />
+<InChatAdSlot formats="visual_banner" theme={{ accent: "purple" }} />
+
+// ✅ Valid - A/B testing with arrays (Simula auto-selects valid combinations)
+<InChatAdSlot
+  formats={['text', 'highlight']}
+  theme={{ accent: ['image', 'transparent'] }}
+/>
+// If 'text' is selected → uses 'transparent' (skips 'image')
+// If 'highlight' is selected → uses 'image' (skips 'transparent')
+
+<InChatAdSlot
+  formats={['interactive', 'visual_banner']}
+  theme={{ accent: ['blue', 'transparent'] }}
+/>
+// If 'interactive' is selected → uses 'blue' (skips 'transparent')
+// If 'visual_banner' is selected → uses 'blue' (skips 'transparent')
+
+// ❌ Invalid - no valid options available
+<InChatAdSlot formats="interactive" theme={{ accent: "transparent" }} />  // interactive cannot use transparent (no fallback)
+<InChatAdSlot formats="text" theme={{ accent: "blue" }} />                // text can ONLY use transparent (no fallback)
+<InChatAdSlot formats="text" theme={{ accent: ['blue', 'red', 'image'] }} />  // text needs transparent but none provided
+```
+
+> **Key Point:** Restrictions only matter when there are **no valid alternatives**. When A/B testing with multiple formats or accents, Simula intelligently matches compatible combinations.

package/dist/InChatAdSlot.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { InChatAdSlotProps } from './types';
+export declare const InChatAdSlot: React.FC<InChatAdSlotProps>;
+//# sourceMappingURL=InChatAdSlot.d.ts.map

package/dist/InChatAdSlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InChatAdSlot.d.ts","sourceRoot":"","sources":["../src/InChatAdSlot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AASjF,OAAO,EAAE,iBAAiB,EAAU,MAAM,SAAS,CAAC;AAepD,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAyXpD,CAAC"}

package/dist/SimulaProvider.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { SimulaProviderProps, SimulaContextValue } from './types';
+export declare const useSimula: () => SimulaContextValue;
+export declare const SimulaProvider: React.FC<SimulaProviderProps>;
+//# sourceMappingURL=SimulaProvider.d.ts.map

package/dist/SimulaProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimulaProvider.d.ts","sourceRoot":"","sources":["../src/SimulaProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyD,MAAM,OAAO,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAMlE,eAAO,MAAM,SAAS,QAAO,kBAM5B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAmCxD,CAAC"}

package/dist/hooks/useBotDetection.d.ts

@@ -0,0 +1,3 @@
+import { BotDetectionResult } from '../types';
+export declare const useBotDetection: () => BotDetectionResult;
+//# sourceMappingURL=useBotDetection.d.ts.map

package/dist/hooks/useBotDetection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBotDetection.d.ts","sourceRoot":"","sources":["../../src/hooks/useBotDetection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,eAAO,MAAM,eAAe,QAAO,kBAmClC,CAAC"}

package/dist/hooks/useDebounce.d.ts

@@ -0,0 +1,2 @@
+export declare const useDebounce: (callback: () => void, delay: number, deps: any[]) => void;
+//# sourceMappingURL=useDebounce.d.ts.map

package/dist/hooks/useDebounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.d.ts","sourceRoot":"","sources":["../../src/hooks/useDebounce.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,IAAI,EAAE,OAAO,MAAM,EAAE,MAAM,GAAG,EAAE,SAwB3E,CAAC"}

package/dist/hooks/useOMIDViewability.d.ts

@@ -0,0 +1,24 @@
+interface OMIDViewabilityResult {
+    isViewable: boolean;
+    hasBeenViewed: boolean;
+    impressionTracked: boolean;
+}
+interface OMIDOptions {
+    threshold?: number;
+    durationMs?: number;
+    partnerName?: string;
+    partnerVersion?: string;
+    onImpressionTracked?: (adId: string) => void;
+}
+declare global {
+    interface Window {
+        omidSessionClient?: any;
+        omidSessionService?: any;
+    }
+}
+export declare const useOMIDViewability: (options?: OMIDOptions) => OMIDViewabilityResult & {
+    elementRef: React.RefObject<HTMLDivElement>;
+    trackImpression: (adId?: string) => void;
+};
+export {};
+//# sourceMappingURL=useOMIDViewability.d.ts.map

package/dist/hooks/useOMIDViewability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOMIDViewability.d.ts","sourceRoot":"","sources":["../../src/hooks/useOMIDViewability.ts"],"names":[],"mappings":"AAEA,UAAU,qBAAqB;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,UAAU,WAAW;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,iBAAiB,CAAC,EAAE,GAAG,CAAC;QACxB,kBAAkB,CAAC,EAAE,GAAG,CAAC;KAC1B;CACF;AAED,eAAO,MAAM,kBAAkB,GAAI,UAAS,WAAgB,KAAG,qBAAqB,GAAG;IACrF,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC5C,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CA0P1C,CAAC"}

package/dist/hooks/useViewability.d.ts

@@ -0,0 +1,6 @@
+import type { ViewabilityResult, ViewabilityOptions } from '../types';
+export declare const useViewability: (options?: ViewabilityOptions) => ViewabilityResult & {
+    elementRef: React.RefObject<HTMLDivElement>;
+    trackImpression: (adId?: string) => void;
+};
+//# sourceMappingURL=useViewability.d.ts.map

package/dist/hooks/useViewability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewability.d.ts","sourceRoot":"","sources":["../../src/hooks/useViewability.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEtE,eAAO,MAAM,cAAc,GAAI,UAAS,kBAAuB,KAAG,iBAAiB,GAAG;IACpF,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC5C,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CA8E1C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,142 @@
+import React$1 from 'react';
+
+type AccentOption = 'blue' | 'red' | 'green' | 'yellow' | 'purple' | 'pink' | 'orange' | 'neutral' | 'gray' | 'tan' | 'transparent' | 'image';
+type FontOption = 'san-serif' | 'serif' | 'monospace';
+interface SimulaTheme {
+    theme?: 'light' | 'dark' | 'auto';
+    accent?: AccentOption | AccentOption[];
+    font?: FontOption | FontOption[];
+    width?: number | string;
+    cornerRadius?: number;
+}
+interface ColorPalette$1 {
+    backgroundGradient1: string;
+    backgroundGradient2: string;
+    primary: string;
+    primaryHover: string;
+    secondary: string;
+    text: string;
+    border: string;
+    buttonText: string;
+}
+interface FontPalette$1 {
+    primary: string;
+    secondary: string;
+}
+interface Message {
+    role: string;
+    content: string;
+}
+interface AdData {
+    id: string;
+    format: string;
+    iframeUrl?: string;
+}
+interface InChatAdSlotProps {
+    messages: Message[];
+    trigger?: Promise<any>;
+    formats?: string | string[];
+    theme?: SimulaTheme;
+    debounceMs?: number;
+    charDesc?: string;
+    onImpression?: (ad: AdData) => void;
+    onClick?: (ad: AdData) => void;
+    onError?: (error: Error) => void;
+}
+interface SimulaProviderProps {
+    apiKey: string;
+    children: React.ReactNode;
+    devMode?: boolean;
+    primaryUserID?: string;
+}
+interface SimulaContextValue {
+    apiKey: string;
+    devMode: boolean;
+    sessionId?: string;
+}
+interface BotDetectionResult {
+    isBot: boolean;
+    reasons: string[];
+}
+interface OMIDViewabilityOptions {
+    threshold?: number;
+    durationMs?: number;
+    partnerName?: string;
+    partnerVersion?: string;
+    onImpressionTracked?: (adId: string) => void;
+}
+interface OMIDViewabilityResult$1 {
+    isViewable: boolean;
+    hasBeenViewed: boolean;
+    impressionTracked: boolean;
+}
+interface ViewabilityOptions {
+    threshold?: number;
+    durationMs?: number;
+    onImpressionTracked?: (adId: string) => void;
+}
+interface ViewabilityResult {
+    isViewable: boolean;
+    isInstantViewable: boolean;
+    hasBeenViewed: boolean;
+    impressionTracked: boolean;
+}
+
+declare const useSimula: () => SimulaContextValue;
+declare const SimulaProvider: React$1.FC<SimulaProviderProps>;
+
+declare const InChatAdSlot: React$1.FC<InChatAdSlotProps>;
+
+declare const useBotDetection: () => BotDetectionResult;
+
+declare const useViewability: (options?: ViewabilityOptions) => ViewabilityResult & {
+    elementRef: React.RefObject<HTMLDivElement>;
+    trackImpression: (adId?: string) => void;
+};
+
+interface OMIDViewabilityResult {
+    isViewable: boolean;
+    hasBeenViewed: boolean;
+    impressionTracked: boolean;
+}
+interface OMIDOptions {
+    threshold?: number;
+    durationMs?: number;
+    partnerName?: string;
+    partnerVersion?: string;
+    onImpressionTracked?: (adId: string) => void;
+}
+declare global {
+    interface Window {
+        omidSessionClient?: any;
+        omidSessionService?: any;
+    }
+}
+declare const useOMIDViewability: (options?: OMIDOptions) => OMIDViewabilityResult & {
+    elementRef: React.RefObject<HTMLDivElement>;
+    trackImpression: (adId?: string) => void;
+};
+
+interface ColorPalette {
+    background: string;
+    text: string;
+    primary: string;
+    primaryHover: string;
+    border: string;
+}
+interface FontPalette {
+    primary: string;
+    secondary: string;
+}
+declare const fonts: Record<string, FontPalette>;
+declare function getColorTheme(themeMode: 'light' | 'dark' | 'auto', _accent?: string): ColorPalette;
+declare const getSolidBackground: (colors: ColorPalette) => string;
+declare const getBackgroundGradient: (colors: ColorPalette) => string;
+declare const getTextMuted: (colors: ColorPalette) => string;
+declare const getTextSecondary: (colors: ColorPalette) => string;
+declare const getBorderLight: (colors: ColorPalette) => string;
+declare const getShadow: (colors: ColorPalette) => string;
+declare const getFontStyles: (font?: string) => FontPalette;
+
+export { InChatAdSlot, SimulaProvider, fonts, getBackgroundGradient, getBorderLight, getColorTheme, getFontStyles, getShadow, getSolidBackground, getTextMuted, getTextSecondary, useBotDetection, useOMIDViewability, useSimula, useViewability };
+export type { AdData, BotDetectionResult, ColorPalette$1 as ColorPalette, FontPalette$1 as FontPalette, InChatAdSlotProps, Message, OMIDViewabilityOptions, OMIDViewabilityResult$1 as OMIDViewabilityResult, SimulaContextValue, SimulaProviderProps, SimulaTheme, ViewabilityOptions, ViewabilityResult };

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGhE,OAAO,EACL,aAAa,EACb,aAAa,EACb,KAAK,EACL,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,SAAS,EACV,MAAM,qBAAqB,CAAC;AAI7B,YAAY,EACV,WAAW,EACX,OAAO,EACP,MAAM,EACN,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACZ,MAAM,SAAS,CAAC"}