npm - playe-developer-sdk - Versions diffs - 1.0.0 - Mend

playe-developer-sdk 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/CHANGELOG.md +68 -0
package/README.md +341 -0
package/dist/index.cjs.js +759 -0
package/dist/index.cjs.js.map +1 -0
package/dist/index.d.ts +458 -0
package/dist/index.esm.js +748 -0
package/dist/index.esm.js.map +1 -0
package/dist/playe-sdk.umd.js +765 -0
package/dist/playe-sdk.umd.js.map +1 -0
package/dist/playe-sdk.umd.min.js +2 -0
package/dist/playe-sdk.umd.min.js.map +1 -0
package/examples/basic-usage.ts +170 -0
package/examples/browser-example.html +520 -0
package/examples/cdn-usage.html +425 -0
package/package.json +90 -0

package/examples/cdn-usage.html ADDED Viewed

@@ -0,0 +1,425 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Playe SDK - CDN Usage Example</title>
+    <style>
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            max-width: 1200px;
+            margin: 0 auto;
+            padding: 20px;
+            background: #f8fafc;
+        }
+        .container {
+            background: white;
+            border-radius: 12px;
+            padding: 30px;
+            box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
+        }
+        h1 {
+            color: #1e293b;
+            margin-bottom: 10px;
+        }
+        .subtitle {
+            color: #64748b;
+            margin-bottom: 30px;
+        }
+        .example-section {
+            margin: 30px 0;
+            padding: 20px;
+            background: #f8fafc;
+            border-radius: 8px;
+            border-left: 4px solid #3b82f6;
+        }
+        .code-block {
+            background: #1e293b;
+            color: #e2e8f0;
+            padding: 15px;
+            border-radius: 6px;
+            font-family: 'Courier New', monospace;
+            font-size: 14px;
+            overflow-x: auto;
+            margin: 10px 0;
+        }
+        button {
+            background: #3b82f6;
+            color: white;
+            border: none;
+            padding: 12px 24px;
+            border-radius: 6px;
+            cursor: pointer;
+            font-weight: 500;
+            margin: 5px;
+            transition: background-color 0.2s;
+        }
+        button:hover {
+            background: #2563eb;
+        }
+        button:disabled {
+            background: #94a3b8;
+            cursor: not-allowed;
+        }
+        .status {
+            padding: 12px;
+            margin: 15px 0;
+            border-radius: 6px;
+            font-weight: 500;
+        }
+        .status.success { background: #dcfce7; color: #166534; border: 1px solid #bbf7d0; }
+        .status.error { background: #fef2f2; color: #dc2626; border: 1px solid #fecaca; }
+        .status.info { background: #dbeafe; color: #1d4ed8; border: 1px solid #bfdbfe; }
+        .log-container {
+            background: #0f172a;
+            color: #e2e8f0;
+            padding: 15px;
+            border-radius: 6px;
+            height: 300px;
+            overflow-y: auto;
+            font-family: 'Courier New', monospace;
+            font-size: 12px;
+            margin: 15px 0;
+        }
+        .log-entry {
+            margin: 2px 0;
+            padding: 2px 0;
+        }
+        .log-entry.info { color: #60a5fa; }
+        .log-entry.success { color: #34d399; }
+        .log-entry.error { color: #f87171; }
+        .log-entry.warning { color: #fbbf24; }
+        .grid {
+            display: grid;
+            grid-template-columns: 1fr 1fr;
+            gap: 20px;
+            margin: 20px 0;
+        }
+        @media (max-width: 768px) {
+            .grid { grid-template-columns: 1fr; }
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <h1>🎮 Playe Developer SDK</h1>
+        <p class="subtitle">CDN Usage Example - No build tools required!</p>
+        <div class="example-section">
+            <h3>📦 Installation Methods</h3>
+            <h4>Option 1: unpkg CDN</h4>
+            <div class="code-block">&lt;script src="https://unpkg.com/playe-developer-sdk@latest/dist/playe-sdk.umd.min.js"&gt;&lt;/script&gt;</div>
+            <h4>Option 2: jsDelivr CDN</h4>
+            <div class="code-block">&lt;script src="https://cdn.jsdelivr.net/npm/playe-developer-sdk@latest/dist/playe-sdk.umd.min.js"&gt;&lt;/script&gt;</div>
+            <h4>Option 3: Local file (for development)</h4>
+            <div class="code-block">&lt;script src="./dist/playe-sdk.umd.min.js"&gt;&lt;/script&gt;</div>
+        </div>
+        <div class="example-section">
+            <h3>🚀 Quick Start</h3>
+            <div class="code-block">// Initialize the SDK
+const sdk = PlayeSDK.createPlayeSDK({
+  apiBaseUrl: 'https://api.playe.com',
+  apiKey: 'your-api-key-here',
+  enableDebugMode: true
+});
+// Use the SDK
+sdk.test('Hello from CDN!');</div>
+        </div>
+        <div class="status info" id="status">
+            Ready to test the SDK
+        </div>
+        <div>
+            <button onclick="initializeSDK()">Initialize SDK</button>
+            <button onclick="testSDK()" disabled id="testBtn">Test SDK</button>
+            <button onclick="startDemoGame()" disabled id="demoBtn">Start Demo Game</button>
+            <button onclick="clearLog()">Clear Log</button>
+        </div>
+        <div class="grid">
+            <div>
+                <h4>📊 SDK Status</h4>
+                <div id="sdkInfo">
+                    <p><strong>Status:</strong> <span id="sdkStatus">Not initialized</span></p>
+                    <p><strong>Version:</strong> <span id="sdkVersion">-</span></p>
+                    <p><strong>Features:</strong> <span id="sdkFeatures">-</span></p>
+                </div>
+            </div>
+            <div>
+                <h4>🎯 Demo Game</h4>
+                <div id="gameInfo">
+                    <p><strong>Session:</strong> <span id="gameSession">None</span></p>
+                    <p><strong>Score:</strong> <span id="gameScore">0</span></p>
+                    <p><strong>Status:</strong> <span id="gameStatus">Idle</span></p>
+                </div>
+            </div>
+        </div>
+        <div>
+            <h4>📝 Console Log</h4>
+            <div class="log-container" id="logContainer"></div>
+        </div>
+        <div class="example-section">
+            <h3>💡 Integration Examples</h3>
+            <h4>Basic Game Integration</h4>
+            <div class="code-block">async function startGame() {
+  try {
+    // Initialize game session
+    const session = await sdk.initializeGameSession({
+      campaignId: 'my-campaign',
+      gameId: 'my-game',
+      playerFingerprint: PlayeSDK.DeviceUtils.generateFingerprint(),
+      playerEmail: 'player@example.com'
+    });
+    // Start the game
+    await sdk.startGameSession(session.sessionId);
+    console.log('Game started!', session.sessionId);
+    // Your game logic here...
+    // Complete the game
+    const result = await sdk.completeGame(session.sessionId, {
+      finalScore: 1500
+    });
+    if (result.isWinner) {
+      alert(`You won $${result.prizeAmount}!`);
+    }
+  } catch (error) {
+    console.error('Game error:', error);
+  }
+}</div>
+            <h4>With Error Handling</h4>
+            <div class="code-block">try {
+  const session = await sdk.initializeGameSession(params);
+} catch (error) {
+  if (error instanceof PlayeSDK.ValidationError) {
+    console.error('Invalid parameters:', error.message);
+  } else if (error instanceof PlayeSDK.NetworkError) {
+    console.error('Network issue:', error.message);
+  } else {
+    console.error('Unknown error:', error);
+  }
+}</div>
+        </div>
+    </div>
+    <!-- Load the SDK from local dist (fallback to CDN) -->
+    <script src="../dist/playe-sdk.umd.min.js"
+            onerror="this.onerror=null; this.src='https://unpkg.com/playe-developer-sdk@latest/dist/playe-sdk.umd.min.js';">
+    </script>
+    <script>
+        let sdk = null;
+        let currentSession = null;
+        // Logging function
+        function log(level, message) {
+            const timestamp = new Date().toLocaleTimeString();
+            const logContainer = document.getElementById('logContainer');
+            const entry = document.createElement('div');
+            entry.className = `log-entry ${level}`;
+            entry.innerHTML = `<span style="color: #64748b;">[${timestamp}]</span> ${message}`;
+            logContainer.appendChild(entry);
+            logContainer.scrollTop = logContainer.scrollHeight;
+        }
+        function updateStatus(message, type = 'info') {
+            const statusEl = document.getElementById('status');
+            statusEl.textContent = message;
+            statusEl.className = `status ${type}`;
+        }
+        function updateSDKInfo() {
+            document.getElementById('sdkStatus').textContent = sdk ? 'Initialized' : 'Not initialized';
+            document.getElementById('sdkVersion').textContent = sdk ? PlayeSDK.VERSION || '1.0.0' : '-';
+            if (sdk) {
+                const features = [];
+                if (PlayeSDK.DeviceUtils) features.push('Device Detection');
+                if (PlayeSDK.ValidationUtils) features.push('Validation');
+                document.getElementById('sdkFeatures').textContent = features.join(', ');
+            }
+        }
+        async function initializeSDK() {
+            try {
+                log('info', 'Initializing Playe Developer SDK...');
+                // Check if SDK is loaded
+                if (typeof PlayeSDK === 'undefined') {
+                    throw new Error('PlayeSDK not loaded. Check your script tag.');
+                }
+                // Initialize SDK
+                sdk = PlayeSDK.createPlayeSDK({
+                    apiBaseUrl: 'https://api.playe.com',
+                    apiKey: 'demo-key-12345',
+                    enableDebugMode: true
+                });
+                log('success', 'SDK initialized successfully!');
+                log('info', `SDK Version: ${PlayeSDK.VERSION || '1.0.0'}`);
+                // Test device utilities
+                const deviceInfo = PlayeSDK.DeviceUtils.getDeviceInfo();
+                log('info', `Device: ${deviceInfo.platform} - ${deviceInfo.screenResolution}`);
+                const fingerprint = PlayeSDK.DeviceUtils.generateFingerprint();
+                log('info', `Fingerprint: ${fingerprint}`);
+                updateStatus('SDK initialized successfully!', 'success');
+                updateSDKInfo();
+                // Enable buttons
+                document.getElementById('testBtn').disabled = false;
+                document.getElementById('demoBtn').disabled = false;
+                document.querySelector('button[onclick="initializeSDK()"]').disabled = true;
+            } catch (error) {
+                log('error', `Failed to initialize SDK: ${error.message}`);
+                updateStatus('SDK initialization failed', 'error');
+            }
+        }
+        function testSDK() {
+            if (!sdk) {
+                log('error', 'SDK not initialized');
+                return;
+            }
+            try {
+                // Test the SDK
+                sdk.test('CDN SDK test successful! 🎉');
+                // Test utilities
+                const features = PlayeSDK.DeviceUtils.getFeatureSupport();
+                log('info', `Browser features: ${Object.entries(features).filter(([k,v]) => v).map(([k]) => k).join(', ')}`);
+                // Test validation
+                try {
+                    PlayeSDK.ValidationUtils.validateInitializeParams({
+                        campaignId: 'test',
+                        gameId: 'test',
+                        playerFingerprint: 'test'
+                    });
+                    log('success', 'Validation test passed');
+                } catch (validationError) {
+                    log('warning', `Validation test: ${validationError.message}`);
+                }
+                updateStatus('SDK test completed', 'success');
+            } catch (error) {
+                log('error', `SDK test failed: ${error.message}`);
+                updateStatus('SDK test failed', 'error');
+            }
+        }
+        async function startDemoGame() {
+            if (!sdk) {
+                log('error', 'SDK not initialized');
+                return;
+            }
+            try {
+                updateStatus('Starting demo game...', 'info');
+                document.getElementById('gameStatus').textContent = 'Starting...';
+                // Mock game session initialization
+                log('info', 'Initializing demo game session...');
+                const fingerprint = PlayeSDK.DeviceUtils.generateFingerprint();
+                const deviceInfo = PlayeSDK.DeviceUtils.getDeviceInfo();
+                // Since this is a demo, we'll simulate the API calls
+                const mockSession = {
+                    sessionId: 'demo_' + Math.random().toString(36).substr(2, 9),
+                    campaignId: 'demo-campaign',
+                    gameId: 'demo-game',
+                    status: 'initialized'
+                };
+                currentSession = mockSession;
+                document.getElementById('gameSession').textContent = mockSession.sessionId;
+                document.getElementById('gameStatus').textContent = 'Active';
+                log('success', `Demo game session created: ${mockSession.sessionId}`);
+                log('info', 'Simulating game play...');
+                // Simulate game progress
+                let score = 0;
+                const gameInterval = setInterval(() => {
+                    score += Math.floor(Math.random() * 100) + 50;
+                    document.getElementById('gameScore').textContent = score;
+                    if (score < 1000) {
+                        log('info', `Score update: ${score}`);
+                    } else {
+                        clearInterval(gameInterval);
+                        finishDemoGame(score);
+                    }
+                }, 1000);
+                updateStatus('Demo game in progress...', 'info');
+            } catch (error) {
+                log('error', `Failed to start demo game: ${error.message}`);
+                updateStatus('Demo game failed to start', 'error');
+            }
+        }
+        function finishDemoGame(finalScore) {
+            const isWinner = finalScore > 1500;
+            log('success', `Demo game completed! Final score: ${finalScore}`);
+            if (isWinner) {
+                log('success', '🎉 Congratulations! You won the demo game!');
+                updateStatus('Demo game won!', 'success');
+            } else {
+                log('info', 'Good try! Better luck next time.');
+                updateStatus('Demo game completed', 'info');
+            }
+            document.getElementById('gameStatus').textContent = isWinner ? 'Won!' : 'Completed';
+            // Reset after 5 seconds
+            setTimeout(() => {
+                document.getElementById('gameSession').textContent = 'None';
+                document.getElementById('gameScore').textContent = '0';
+                document.getElementById('gameStatus').textContent = 'Idle';
+                currentSession = null;
+            }, 5000);
+        }
+        function clearLog() {
+            document.getElementById('logContainer').innerHTML = '';
+        }
+        // Initialize on page load
+        window.addEventListener('load', () => {
+            log('info', '🎮 Playe Developer SDK CDN Example loaded');
+            log('info', 'Click "Initialize SDK" to get started');
+            // Check if SDK is available
+            if (typeof PlayeSDK !== 'undefined') {
+                log('success', 'PlayeSDK loaded from CDN successfully');
+            } else {
+                log('error', 'PlayeSDK not found. Check your internet connection or script tag.');
+            }
+        });
+    </script>
+</body>
+</html>

package/package.json ADDED Viewed

@@ -0,0 +1,90 @@
+{
+  "name": "playe-developer-sdk",
+  "version": "1.0.0",
+  "type": "module",
+  "private": false,
+  "description": "Enhanced Game Developer SDK for browser-based projects - integrate games with campaigns, leaderboards, and anti-cheat protection",
+  "main": "./dist/index.cjs.js",
+  "module": "./dist/index.esm.js",
+  "browser": "./dist/playe-sdk.umd.js",
+  "types": "./dist/index.d.ts",
+  "unpkg": "./dist/playe-sdk.umd.min.js",
+  "jsdelivr": "./dist/playe-sdk.umd.min.js",
+  "scripts": {
+    "build": "node scripts/build.js",
+    "build:dev": "rollup -c --watch",
+    "build:prod": "NODE_ENV=production node scripts/build.js --npm",
+    "build:workspace": "node scripts/build.js --workspace",
+    "build:npm": "node scripts/build.js --npm",
+    "build:legacy": "tsc",
+    "dev": "rollup -c --watch",
+    "lint": "eslint . --max-warnings 0",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "pnpm run build:npm",
+    "prepack": "pnpm run build:npm",
+    "test:build": "node scripts/build.js && node -e \"console.log('Testing imports...'); import('./dist/index.esm.js').then(() => console.log('✅ ESM import works')); require('./dist/index.cjs.js'); console.log('✅ CJS require works');\""
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^28.0.6",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.1.4",
+    "@types/node": "^24",
+    "rollup": "^4.46.2",
+    "rollup-plugin-dts": "^6.2.1",
+    "typescript": "^5.9.0-beta"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs.js",
+      "browser": "./dist/playe-sdk.umd.js",
+      "default": "./dist/index.esm.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "CHANGELOG.md",
+    "examples/**/*"
+  ],
+  "keywords": [
+    "game",
+    "sdk",
+    "developer",
+    "browser",
+    "playe",
+    "gaming",
+    "campaigns",
+    "leaderboard",
+    "anti-cheat",
+    "typescript",
+    "javascript",
+    "web-games",
+    "prize-campaigns",
+    "gamification"
+  ],
+  "homepage": "https://github.com/playe/playe/tree/main/packages/playe-developer-sdk",
+  "bugs": {
+    "url": "https://github.com/playe/playe/issues"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "browserslist": [
+    "Chrome >= 60",
+    "Firefox >= 55",
+    "Safari >= 12",
+    "Edge >= 79"
+  ],
+  "author": "Playe Team",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/playe/playe.git",
+    "directory": "packages/playe-developer-sdk"
+  }
+}