@adtogether/web-sdk 0.1.26 → 0.2.0

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.2.0
+* **Security**: Implemented strict validation for required parameters and API keys.
+* **Error Handling**: Improved error handling for invalid or missing App IDs across all platforms, ensuring graceful failures with descriptive logs.
+
 ## 0.1.25
 * **Docs**: Standardized SDK documentation across all platforms.
 

package/README.md

@@ -22,7 +22,7 @@
 This SDK allows web developers (React and Vanilla JS) to easily integrate AdTogether ads into their applications. By displaying ads from other community members, you earn **Ad Credits** that allow your own app's ads to be shown across the AdTogether network.
 
 <p align="center">
-  <img src="../../public/dashboard.png" width="800" alt="Developer Dashboard">
+  <img src="https://adtogether.relaxsoftwareapps.com/dashboard.png" width="800" alt="Developer Dashboard">
 </p>
 
 ### 🖼️ Visualizing the Experience
@@ -92,7 +92,7 @@ function MyApp() {
 
 | Prop               | Type                    | Default   | Description |
 |--------------------|-------------------------|-----------|-------------|
-| `adUnitId`         | `string`                | **required** | Unique identifier for this ad placement. |
+| `adUnitId`         | `string`                | `'default'`  | Optional label for this ad placement (e.g. `'home_banner'`, `'sidebar'`). Used for analytics grouping only — not validated server-side. |
 | `showCloseButton`  | `boolean`               | `false`   | Show a dismissable close button overlay. |
 | `onAdClosed`       | `() => void`            | —         | Called when the user closes the ad. |
 | `width`            | `number \| string`      | `'100%'`  | Width of the ad element. |
@@ -137,7 +137,7 @@ function MyApp() {
 
 | Prop               | Type                    | Default   | Description |
 |--------------------|-------------------------|-----------|-------------|
-| `adUnitId`         | `string`                | **required** | Unique identifier for this ad placement. |
+| `adUnitId`         | `string`                | `'default'`  | Optional label for this ad placement. Used for analytics grouping only. |
 | `isOpen`           | `boolean`               | **required** | When `true`, the interstitial is displayed. |
 | `onClose`          | `() => void`            | **required** | Called when the user closes the interstitial. |
 | `closeDelay`       | `number`                | `3`       | Seconds before the close button appears. A countdown is shown during this time. |

package/dist/{chunk-V3TR7YMJ.mjs → chunk-AFLHEFSH.mjs}

@@ -60,6 +60,9 @@ var AdTogether = class _AdTogether {
         const ad = await response.json();
         sdk.lastAdId = ad.id;
         return ad;
+      } else if (response.status === 401 || response.status === 403) {
+        console.error("AdTogether Error: Invalid App ID. Please check your dashboard.");
+        throw new Error(`AdTogether Error: Invalid App ID. Status: ${response.status}`);
       }
       throw new Error(`Failed to fetch ad. Status: ${response.status}`);
     } catch (err) {

package/dist/index.js

@@ -86,6 +86,9 @@ var AdTogether = class _AdTogether {
         const ad = await response.json();
         sdk.lastAdId = ad.id;
         return ad;
+      } else if (response.status === 401 || response.status === 403) {
+        console.error("AdTogether Error: Invalid App ID. Please check your dashboard.");
+        throw new Error(`AdTogether Error: Invalid App ID. Status: ${response.status}`);
       }
       throw new Error(`Failed to fetch ad. Status: ${response.status}`);
     } catch (err) {

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import {
   AdTogether
-} from "./chunk-V3TR7YMJ.mjs";
+} from "./chunk-AFLHEFSH.mjs";
 export {
   AdTogether
 };

package/dist/react/index.js

@@ -90,6 +90,9 @@ var AdTogether = class _AdTogether {
         const ad = await response.json();
         sdk.lastAdId = ad.id;
         return ad;
+      } else if (response.status === 401 || response.status === 403) {
+        console.error("AdTogether Error: Invalid App ID. Please check your dashboard.");
+        throw new Error(`AdTogether Error: Invalid App ID. Status: ${response.status}`);
       }
       throw new Error(`Failed to fetch ad. Status: ${response.status}`);
     } catch (err) {

package/dist/react/index.mjs

@@ -1,6 +1,6 @@
 import {
   AdTogether
-} from "../chunk-V3TR7YMJ.mjs";
+} from "../chunk-AFLHEFSH.mjs";
 
 // src/react/AdTogetherBanner.tsx
 import { useEffect, useRef, useState } from "react";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adtogether/web-sdk",
-  "version": "0.1.26",
+  "version": "0.2.0",
   "description": "The official AdTogether Web SDK — reciprocal ad exchange to increase conversions and grow your audience.",
   "repository": {
     "type": "git",

package/src/core/AdTogether.ts

@@ -79,6 +79,9 @@ export class AdTogether {
         const ad = await response.json();
         sdk.lastAdId = ad.id;
         return ad;
+      } else if (response.status === 401 || response.status === 403) {
+        console.error('AdTogether Error: Invalid App ID. Please check your dashboard.');
+        throw new Error(`AdTogether Error: Invalid App ID. Status: ${response.status}`);
       }
 
       throw new Error(`Failed to fetch ad. Status: ${response.status}`);