@smoud/playable-sdk 1.0.8 → 1.0.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present Smoud
+
+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

@@ -6,7 +6,7 @@
 [![DeepScan grade](https://deepscan.io/api/teams/19616/projects/29066/branches/935410/badge/grade.svg)](https://deepscan.io/dashboard#view=project&tid=19616&pid=29066&bid=935410)
 [![License](https://img.shields.io/npm/l/@smoud/playable-sdk)](https://opensource.org/license/MIT)
 
-It's powerful, unified SDK that seamlessly integrates multiple ad network SDKs, including MRAID, Google, Facebook, Vungle, and many more. Designed for effortless playable ad development, it provides a standardized interface, ensuring compatibility, optimization, and easy deployment across various platforms. With @smoud/playable-sdk, you can streamline your workflow, maximize reach, and focus on crafting engaging interactive ads without worrying about SDK fragmentation. 🚀
+It's powerful, unified SDK that seamlessly integrates multiple ad network SDKs, including MRAID, Google, Facebook, Vungle, and many more. Designed for effortless playable ad development, it provides a standardized interface, ensuring compatibility, optimization, and easy deployment across various platforms. With `@smoud/playable-sdk`, you can streamline your workflow, maximize reach, and focus on crafting engaging interactive ads without worrying about SDK fragmentation. 🚀
 
 ## Features
 
@@ -143,20 +143,6 @@ To generate a playable ad ready for an ad network, use the build command:
 npm run build <ad-network>
 ```
 
-##### Examples:
-
-To build for **Applovin**, run:
-
-```sh
-npm run build applovin
-```
-
-To build for **IronSource DAPI**, run:
-
-```sh
-npm run build ironsource -- --protocol dapi
-```
-
 Supported **Ad Networks**:
 
 - `applovin`
@@ -177,13 +163,15 @@ Supported **Ad Networks**:
 - `mytarget`
 - `liftoff`
 
-## Custom Build Pipeline
+See more details in [`GitHub repository.`](https://github.com/smoudjs/playable-scripts?tab=readme-ov-file#installation)
+
+### Custom Build Pipeline
 
-Before setting up a custom pipeline, consider using `@smoud/playable-scripts`. It provides an API to extend the standard build function and simplifies the process. See details [here](https://github.com/smoudjs/playable-scripts).
+Before setting up a custom pipeline, consider using `@smoud/playable-scripts`. It provides an API to extend the standard build function and simplifies the process. See more details [here](https://github.com/smoudjs/playable-scripts).
 
 If you still prefer a fully custom build, you need to manage the following aspects yourself:
 
-### 1️⃣ Define Required Variables
+#### 1️⃣ Define Required Variables
 
 Your build script should replace or define these variables within the `window` object before the rest of your code executes:
 
@@ -195,17 +183,17 @@ APP_STORE_URL = 'https://apps.apple.com/app/id123456789';
 BUILD_HASH = 'random-build-hash';
 ```
 
-### 2️ Applying Ad-Specific Adjustments
+#### 2️⃣ Applying Ad-Specific Adjustments
 
 Certain networks use different ad protocols. Ensure that your build includes or removes code based on the network.
 
 Check [Ad Network Resources & Requirements](#Ad-Network-Resources-&-Requirements) for more details.
 
-### 3️⃣ Minification & Optimization
+#### 3️⃣ Minification & Optimization
 
 To ensure the best performance, your build should include a **JavaScript minimizer** to remove unnecessary code.
 
-#### Recommended Tools:
+##### Recommended Tools:
 
 - [Terser](https://github.com/terser/terser) – Best for JS minification.
 - [UglifyJS](https://github.com/mishoo/UglifyJS) – Alternative for JS compression.
@@ -372,6 +360,16 @@ sdk.off('eventName', [callback], [context]);
 | `sdk.volume`       | number  | Default volume level (0-1), when muting/unmuting audio |
 | `sdk.interactions` | number  | User interaction count                                 |
 
+## Demo Projects
+
+Get started quickly with our template projects:
+
+- [playable-template-base](https://github.com/smoudjs/playable-template-base) - Clean TypeScript starter with minimal dependencies
+- [playable-template-base-js](https://github.com/smoudjs/playable-template-base-js) - Clean JavaScript starter with minimal dependencies
+- [playable-template-pixi](https://github.com/smoudjs/playable-template-pixi) - PixiJS template for 2D playable ads
+- [playable-template-three](https://github.com/smoudjs/playable-template-three) - Three.js template for 3D playable ads
+- [playable-template-phaser](https://github.com/smoudjs/playable-template-phaser) - Phaser template for 2D playable ads
+
 ## References
 
 ### Ad Network Resources & Requirements

package/dist/esm/index.js

@@ -120,7 +120,7 @@ function ensureProtocol() {
 }
 
 // src/core.ts
-var destinationUrl = /android/i.test(navigator.userAgent) ? GOOGLE_PLAY_URL : APP_STORE_URL;
+var destinationUrl = "";
 var isSDKInitialized = false;
 var isProtocolInitialized = false;
 var isForcePaused = false;
@@ -241,7 +241,6 @@ function startDapiProtocol() {
   }
 }
 function startDefaultProtocol() {
-  if ("none" !== AD_PROTOCOL) return;
   if (!isProtocolInitialized) {
     if ("mintegral" === AD_NETWORK) {
       window.mintGameStart = function() {
@@ -333,6 +332,7 @@ var _sdk = class _sdk {
    */
   static init(callback) {
     if (isSDKInitialized) return;
+    destinationUrl = /android/i.test(navigator.userAgent) ? GOOGLE_PLAY_URL : APP_STORE_URL;
     ensureProtocol();
     if (callback) initCallback = callback;
     if ("mraid" === AD_PROTOCOL && isMraid()) {

package/dist/iife/index.js

@@ -122,7 +122,7 @@
   }
 
   // src/core.ts
-  var destinationUrl = /android/i.test(navigator.userAgent) ? GOOGLE_PLAY_URL : APP_STORE_URL;
+  var destinationUrl = "";
   var isSDKInitialized = false;
   var isProtocolInitialized = false;
   var isForcePaused = false;
@@ -243,7 +243,6 @@
     }
   }
   function startDefaultProtocol() {
-    if ("none" !== AD_PROTOCOL) return;
     if (!isProtocolInitialized) {
       if ("mintegral" === AD_NETWORK) {
         window.mintGameStart = function() {
@@ -335,6 +334,7 @@
      */
     static init(callback) {
       if (isSDKInitialized) return;
+      destinationUrl = /android/i.test(navigator.userAgent) ? GOOGLE_PLAY_URL : APP_STORE_URL;
       ensureProtocol();
       if (callback) initCallback = callback;
       if ("mraid" === AD_PROTOCOL && isMraid()) {

package/dist/index.js

@@ -147,7 +147,7 @@ function ensureProtocol() {
 }
 
 // src/core.ts
-var destinationUrl = /android/i.test(navigator.userAgent) ? GOOGLE_PLAY_URL : APP_STORE_URL;
+var destinationUrl = "";
 var isSDKInitialized = false;
 var isProtocolInitialized = false;
 var isForcePaused = false;
@@ -268,7 +268,6 @@ function startDapiProtocol() {
   }
 }
 function startDefaultProtocol() {
-  if ("none" !== AD_PROTOCOL) return;
   if (!isProtocolInitialized) {
     if ("mintegral" === AD_NETWORK) {
       window.mintGameStart = function() {
@@ -360,6 +359,7 @@ var _sdk = class _sdk {
    */
   static init(callback) {
     if (isSDKInitialized) return;
+    destinationUrl = /android/i.test(navigator.userAgent) ? GOOGLE_PLAY_URL : APP_STORE_URL;
     ensureProtocol();
     if (callback) initCallback = callback;
     if ("mraid" === AD_PROTOCOL && isMraid()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smoud/playable-sdk",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "It's unified Playable SDK that supports MRAID, Google, Facebook, Vungle, and many more Ad Networks, simplifying playable ad development with a standardized interface for seamless cross-network compatibility.",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",
@@ -11,6 +11,7 @@
   },
   "files": [
     "dist",
+    "LICENSE",
     "README.md",
     "defines.d.ts"
   ],