playkit-sdk 1.2.1-beta.1 → 1.2.3

package/LICENSE

@@ -1,86 +1,86 @@
-PlayKit SDK License Agreement
-
-Copyright (c) 2025 Agentland Lab. All rights reserved.
-
-NOTICE: This software and its documentation are proprietary products of Agentland Lab.
-
-TERMS AND CONDITIONS
-
-1. GRANT OF LICENSE
-   Subject to the terms and conditions of this Agreement, Agentland Lab grants you a
-   limited, non-exclusive, non-transferable, revocable license to use the PlayKit SDK
-   solely for the purpose of developing and operating games that integrate with the
-   PlayKit platform.2
-
-2. RESTRICTIONS
-   You may NOT:
-   a) Modify, adapt, translate, reverse engineer, decompile, or disassemble the SDK
-   b) Remove or alter any copyright, trademark, or proprietary notices
-   c) Use the SDK to develop competing products or services
-   d) Redistribute, sublicense, rent, lease, or lend the SDK to third parties
-   e) Use the SDK in any manner that violates applicable laws or regulations
-   f) Use the SDK to create malicious, harmful, or illegal applications
-
-3. OWNERSHIP
-   Agentland Lab retains all right, title, and interest in and to the SDK, including
-   all intellectual property rights. This license does not grant you any rights to
-   trademarks, service marks, or trade names of Agentland Lab.
-
-4. API USAGE AND BILLING
-   a) Use of the SDK requires a valid Agentland Lab account
-   b) API usage will be billed according to Agentland Lab' current pricing structure
-   c) You are responsible for all charges incurred through your use of the SDK
-   d) Agentland Lab reserves the right to modify pricing with reasonable notice
-
-5. DEVELOPER TOKEN
-   a) Developer tokens are provided for development and testing purposes only
-   b) Developer tokens must not be used in production environments
-   c) You are responsible for keeping your developer tokens confidential
-   d) Agentland Lab may revoke developer tokens at any time
-
-6. DATA AND PRIVACY
-   a) You are responsible for complying with all applicable data protection laws
-   b) You must provide appropriate privacy notices to your end users
-   c) Agentland Lab' collection and use of data is governed by its Privacy Policy
-
-7. TERMINATION
-   a) This license is effective until terminated
-   b) Agentland Lab may terminate this license at any time if you breach any terms
-   c) Upon termination, you must cease all use of the SDK and destroy all copies
-   d) Termination does not relieve you of any payment obligations
-
-8. WARRANTY DISCLAIMER
-   THE SDK IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
-   INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
-   PARTICULAR PURPOSE, AND NON-INFRINGEMENT. Agentland Lab DOES NOT WARRANT THAT
-   THE SDK WILL BE ERROR-FREE OR UNINTERRUPTED.
-
-9. LIMITATION OF LIABILITY
-   IN NO EVENT SHALL Agentland Lab BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
-   CONSEQUENTIAL, OR PUNITIVE DAMAGES, INCLUDING BUT NOT LIMITED TO LOSS OF PROFITS,
-   DATA, OR USE, ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE USE OF THE SDK,
-   EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
-
-10. SUPPORT AND UPDATES
-    a) Agentland Lab may, but is not obligated to, provide support or updates
-    b) Updates may be subject to additional or different license terms
-    c) You are responsible for implementing updates in a timely manner
-
-11. MODIFICATIONS TO TERMS
-    Agentland Lab reserves the right to modify these terms at any time. Continued
-    use of the SDK after modifications constitutes acceptance of the new terms.
-
-12. GOVERNING LAW
-    This Agreement shall be governed by and construed in accordance with the laws
-    of the jurisdiction in which Agentland Lab is registered, without regard to
-    its conflict of law provisions.
-
-13. ENTIRE AGREEMENT
-    This Agreement constitutes the entire agreement between you and Agentland Lab
-    regarding the SDK and supersedes all prior agreements and understandings.
-
-14. CONTACT
-    For questions about this license, contact: legal@Agentland Lab.com
-
-BY USING THE SDK, YOU ACKNOWLEDGE THAT YOU HAVE READ THIS AGREEMENT, UNDERSTAND IT,
-AND AGREE TO BE BOUND BY ITS TERMS AND CONDITIONS.
+PlayKit SDK License Agreement
+
+Copyright (c) 2025 Agentland Lab. All rights reserved.
+
+NOTICE: This software and its documentation are proprietary products of Agentland Lab.
+
+TERMS AND CONDITIONS
+
+1. GRANT OF LICENSE
+   Subject to the terms and conditions of this Agreement, Agentland Lab grants you a
+   limited, non-exclusive, non-transferable, revocable license to use the PlayKit SDK
+   solely for the purpose of developing and operating games that integrate with the
+   PlayKit platform.2
+
+2. RESTRICTIONS
+   You may NOT:
+   a) Modify, adapt, translate, reverse engineer, decompile, or disassemble the SDK
+   b) Remove or alter any copyright, trademark, or proprietary notices
+   c) Use the SDK to develop competing products or services
+   d) Redistribute, sublicense, rent, lease, or lend the SDK to third parties
+   e) Use the SDK in any manner that violates applicable laws or regulations
+   f) Use the SDK to create malicious, harmful, or illegal applications
+
+3. OWNERSHIP
+   Agentland Lab retains all right, title, and interest in and to the SDK, including
+   all intellectual property rights. This license does not grant you any rights to
+   trademarks, service marks, or trade names of Agentland Lab.
+
+4. API USAGE AND BILLING
+   a) Use of the SDK requires a valid Agentland Lab account
+   b) API usage will be billed according to Agentland Lab' current pricing structure
+   c) You are responsible for all charges incurred through your use of the SDK
+   d) Agentland Lab reserves the right to modify pricing with reasonable notice
+
+5. DEVELOPER TOKEN
+   a) Developer tokens are provided for development and testing purposes only
+   b) Developer tokens must not be used in production environments
+   c) You are responsible for keeping your developer tokens confidential
+   d) Agentland Lab may revoke developer tokens at any time
+
+6. DATA AND PRIVACY
+   a) You are responsible for complying with all applicable data protection laws
+   b) You must provide appropriate privacy notices to your end users
+   c) Agentland Lab' collection and use of data is governed by its Privacy Policy
+
+7. TERMINATION
+   a) This license is effective until terminated
+   b) Agentland Lab may terminate this license at any time if you breach any terms
+   c) Upon termination, you must cease all use of the SDK and destroy all copies
+   d) Termination does not relieve you of any payment obligations
+
+8. WARRANTY DISCLAIMER
+   THE SDK IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+   INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+   PARTICULAR PURPOSE, AND NON-INFRINGEMENT. Agentland Lab DOES NOT WARRANT THAT
+   THE SDK WILL BE ERROR-FREE OR UNINTERRUPTED.
+
+9. LIMITATION OF LIABILITY
+   IN NO EVENT SHALL Agentland Lab BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
+   CONSEQUENTIAL, OR PUNITIVE DAMAGES, INCLUDING BUT NOT LIMITED TO LOSS OF PROFITS,
+   DATA, OR USE, ARISING OUT OF OR RELATED TO THIS AGREEMENT OR THE USE OF THE SDK,
+   EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+10. SUPPORT AND UPDATES
+    a) Agentland Lab may, but is not obligated to, provide support or updates
+    b) Updates may be subject to additional or different license terms
+    c) You are responsible for implementing updates in a timely manner
+
+11. MODIFICATIONS TO TERMS
+    Agentland Lab reserves the right to modify these terms at any time. Continued
+    use of the SDK after modifications constitutes acceptance of the new terms.
+
+12. GOVERNING LAW
+    This Agreement shall be governed by and construed in accordance with the laws
+    of the jurisdiction in which Agentland Lab is registered, without regard to
+    its conflict of law provisions.
+
+13. ENTIRE AGREEMENT
+    This Agreement constitutes the entire agreement between you and Agentland Lab
+    regarding the SDK and supersedes all prior agreements and understandings.
+
+14. CONTACT
+    For questions about this license, contact: legal@Agentland Lab.com
+
+BY USING THE SDK, YOU ACKNOWLEDGE THAT YOU HAVE READ THIS AGREEMENT, UNDERSTAND IT,
+AND AGREE TO BE BOUND BY ITS TERMS AND CONDITIONS.

package/README.md

@@ -1,244 +1,244 @@
-# PlayKit SDK for JavaScript
-
-[![npm version](https://img.shields.io/npm/v/playkit-sdk.svg)](https://www.npmjs.com/package/playkit)
-
-JavaScript/TypeScript SDK for integrating AI capabilities into web-based games.
-
-## Features
-
-- AI-powered text generation using GPT models
-- Image generation using DALL-E models
-- NPC conversation management with automatic history tracking
-- JWT-based authentication and token management
-- Real-time streaming responses
-- Framework-agnostic design (compatible with P5.js, Phaser, PixiJS, etc.)
-- Multiple bundle formats (ESM, CJS, UMD)
-- Encrypted token storage using Web Crypto API
-- Full TypeScript support with type definitions
-- Player balance management and recharge functionality
-
-## Installation
-
-```bash
-npm install playkit-sdk
-```
-
-## Quick Start
-
-### Basic Setup
-
-```typescript
-import { PlayKitSDK } from 'playkit-sdk';
-
-const sdk = new PlayKitSDK({
-  gameId: 'your-game-id',
-  developerToken: 'your-dev-token', // For development
-});
-
-await sdk.initialize();
-```
-
-### Text Generation
-
-```typescript
-const chat = sdk.createChatClient('gpt-4o-mini');
-
-// Simple chat
-const response = await chat.chat('Hello, introduce yourself');
-console.log(response);
-
-// With system prompt
-const response = await chat.chat(
-  'How should I explore this dungeon?',
-  'You are a wise dungeon guide.'
-);
-```
-
-### Streaming Text
-
-```typescript
-await chat.chatStream(
-  'Tell a story about a brave knight',
-  (chunk) => {
-    process.stdout.write(chunk);
-  },
-  (fullText) => {
-    console.log('\nComplete:', fullText);
-  }
-);
-```
-
-### Image Generation
-
-```typescript
-const imageClient = sdk.createImageClient('dall-e-3');
-
-const image = await imageClient.generate('A futuristic cyberpunk city at night');
-
-console.log('Base64:', image.base64);
-console.log('Data URL:', image.toDataURL());
-
-// Display in browser
-const imgElement = await image.toHTMLImage();
-document.body.appendChild(imgElement);
-```
-
-### NPC Conversations
-
-```typescript
-const npc = sdk.createNPCClient({
-  systemPrompt: 'You are a mysterious wizard who speaks in riddles.',
-  temperature: 0.8,
-  maxHistoryLength: 20,
-});
-
-const reply1 = await npc.talk('Who are you?');
-console.log('Wizard:', reply1);
-
-const reply2 = await npc.talk('What is your quest?');
-console.log('Wizard:', reply2);
-
-// Save/load history
-const savedHistory = npc.saveHistory();
-localStorage.setItem('npc_history', savedHistory);
-
-// Later...
-npc.loadHistory(localStorage.getItem('npc_history'));
-```
-
-### Player Balance Management
-
-```typescript
-// Get player info and balance
-const playerInfo = await sdk.getPlayerInfo();
-console.log('Player ID:', playerInfo.userId);
-console.log('Credits:', playerInfo.credits);
-
-// Open recharge window
-sdk.openRechargeWindow();
-
-// Show insufficient balance modal
-await sdk.showInsufficientBalanceModal();
-
-// Enable automatic balance checking
-sdk.enableAutoBalanceCheck(30000); // Check every 30 seconds
-
-// Listen to balance events
-sdk.on('balance_updated', (credits) => {
-  console.log('New balance:', credits);
-});
-
-sdk.on('insufficient_credits', (error) => {
-  console.log('User needs to recharge');
-});
-```
-
-## Usage with P5.js
-
-```javascript
-let sdk, npc, generatedImage;
-
-async function setup() {
-  createCanvas(800, 600);
-
-  sdk = new PlayKitSDK({
-    gameId: 'your-game-id',
-    developerToken: 'your-dev-token'
-  });
-  await sdk.initialize();
-
-  npc = sdk.createNPCClient({
-    systemPrompt: 'You are a friendly game character.'
-  });
-}
-
-async function mousePressed() {
-  const reply = await npc.talk('Hello!');
-  console.log(reply);
-
-  const imageClient = sdk.createImageClient();
-  const img = await imageClient.generate('A magical forest');
-
-  const htmlImg = await img.toHTMLImage();
-  generatedImage = loadImage(htmlImg.src);
-}
-
-function draw() {
-  background(220);
-  if (generatedImage) {
-    image(generatedImage, 0, 0, 400, 400);
-  }
-  text('Click to talk to NPC or generate image', 10, height - 20);
-}
-```
-
-## Usage with Vanilla JavaScript
-
-```html
-<!DOCTYPE html>
-<html>
-<head>
-  <script src="https://unpkg.com/playkit-sdk@latest/dist/index.umd.js"></script>
-</head>
-<body>
-  <div id="output"></div>
-  <input id="userInput" type="text" placeholder="Type a message...">
-  <button onclick="sendMessage()">Send</button>
-
-  <script>
-    let sdk, chat;
-
-    async function init() {
-      sdk = new PlayKitSDK.PlayKitSDK({
-        gameId: 'your-game-id',
-        developerToken: 'your-dev-token'
-      });
-
-      await sdk.initialize();
-      chat = sdk.createChatClient();
-    }
-
-    async function sendMessage() {
-      const input = document.getElementById('userInput').value;
-      const output = document.getElementById('output');
-
-      output.innerHTML += `<p><strong>You:</strong> ${input}</p>`;
-      output.innerHTML += `<p><strong>AI:</strong> <span id="aiReply"></span></p>`;
-
-      const replyElement = document.getElementById('aiReply');
-      await chat.chatStream(
-        input,
-        (chunk) => { replyElement.innerHTML += chunk; }
-      );
-
-      document.getElementById('userInput').value = '';
-    }
-
-    init();
-  </script>
-</body>
-</html>
-```
-
-
-## License
-
-Proprietary License - see [LICENSE](LICENSE) file for details.
-
-This SDK is proprietary software owned by Agentland Lab. Use of this SDK is subject to the terms and conditions of the license agreement.
-
-## Support
-
-- Email: support@agentlandlab.com
-- Issues: [GitHub Issues](https://github.com/cnqdztp/DeveloperWorks-JavascriptSDK/issues)
-
-## Changelog
-
-### 1.0.0-beta.1
-- Initial public beta release
-- AI chat support (text generation)
-- Image generation support
-- NPC conversation management
-- Authentication and player management
-- Streaming response support
-- Player balance management and recharge functionality
+# PlayKit SDK for JavaScript
+
+[![npm version](https://img.shields.io/npm/v/playkit-sdk.svg)](https://www.npmjs.com/package/playkit)
+
+JavaScript/TypeScript SDK for integrating AI capabilities into web-based games.
+
+## Features
+
+- AI-powered text generation using GPT models
+- Image generation using DALL-E models
+- NPC conversation management with automatic history tracking
+- JWT-based authentication and token management
+- Real-time streaming responses
+- Framework-agnostic design (compatible with P5.js, Phaser, PixiJS, etc.)
+- Multiple bundle formats (ESM, CJS, UMD)
+- Encrypted token storage using Web Crypto API
+- Full TypeScript support with type definitions
+- Player balance management and recharge functionality
+
+## Installation
+
+```bash
+npm install playkit-sdk
+```
+
+## Quick Start
+
+### Basic Setup
+
+```typescript
+import { PlayKitSDK } from 'playkit-sdk';
+
+const sdk = new PlayKitSDK({
+  gameId: 'your-game-id',
+  developerToken: 'your-dev-token', // For development
+});
+
+await sdk.initialize();
+```
+
+### Text Generation
+
+```typescript
+const chat = sdk.createChatClient('gpt-4o-mini');
+
+// Simple chat
+const response = await chat.chat('Hello, introduce yourself');
+console.log(response);
+
+// With system prompt
+const response = await chat.chat(
+  'How should I explore this dungeon?',
+  'You are a wise dungeon guide.'
+);
+```
+
+### Streaming Text
+
+```typescript
+await chat.chatStream(
+  'Tell a story about a brave knight',
+  (chunk) => {
+    process.stdout.write(chunk);
+  },
+  (fullText) => {
+    console.log('\nComplete:', fullText);
+  }
+);
+```
+
+### Image Generation
+
+```typescript
+const imageClient = sdk.createImageClient('dall-e-3');
+
+const image = await imageClient.generate('A futuristic cyberpunk city at night');
+
+console.log('Base64:', image.base64);
+console.log('Data URL:', image.toDataURL());
+
+// Display in browser
+const imgElement = await image.toHTMLImage();
+document.body.appendChild(imgElement);
+```
+
+### NPC Conversations
+
+```typescript
+const npc = sdk.createNPCClient({
+  systemPrompt: 'You are a mysterious wizard who speaks in riddles.',
+  temperature: 0.8,
+  maxHistoryLength: 20,
+});
+
+const reply1 = await npc.talk('Who are you?');
+console.log('Wizard:', reply1);
+
+const reply2 = await npc.talk('What is your quest?');
+console.log('Wizard:', reply2);
+
+// Save/load history
+const savedHistory = npc.saveHistory();
+localStorage.setItem('npc_history', savedHistory);
+
+// Later...
+npc.loadHistory(localStorage.getItem('npc_history'));
+```
+
+### Player Balance Management
+
+```typescript
+// Get player info and balance
+const playerInfo = await sdk.getPlayerInfo();
+console.log('Player ID:', playerInfo.userId);
+console.log('Credits:', playerInfo.credits);
+
+// Open recharge window
+sdk.openRechargeWindow();
+
+// Show insufficient balance modal
+await sdk.showInsufficientBalanceModal();
+
+// Enable automatic balance checking
+sdk.enableAutoBalanceCheck(30000); // Check every 30 seconds
+
+// Listen to balance events
+sdk.on('balance_updated', (credits) => {
+  console.log('New balance:', credits);
+});
+
+sdk.on('insufficient_credits', (error) => {
+  console.log('User needs to recharge');
+});
+```
+
+## Usage with P5.js
+
+```javascript
+let sdk, npc, generatedImage;
+
+async function setup() {
+  createCanvas(800, 600);
+
+  sdk = new PlayKitSDK({
+    gameId: 'your-game-id',
+    developerToken: 'your-dev-token'
+  });
+  await sdk.initialize();
+
+  npc = sdk.createNPCClient({
+    systemPrompt: 'You are a friendly game character.'
+  });
+}
+
+async function mousePressed() {
+  const reply = await npc.talk('Hello!');
+  console.log(reply);
+
+  const imageClient = sdk.createImageClient();
+  const img = await imageClient.generate('A magical forest');
+
+  const htmlImg = await img.toHTMLImage();
+  generatedImage = loadImage(htmlImg.src);
+}
+
+function draw() {
+  background(220);
+  if (generatedImage) {
+    image(generatedImage, 0, 0, 400, 400);
+  }
+  text('Click to talk to NPC or generate image', 10, height - 20);
+}
+```
+
+## Usage with Vanilla JavaScript
+
+```html
+<!DOCTYPE html>
+<html>
+<head>
+  <script src="https://unpkg.com/playkit-sdk@latest/dist/index.umd.js"></script>
+</head>
+<body>
+  <div id="output"></div>
+  <input id="userInput" type="text" placeholder="Type a message...">
+  <button onclick="sendMessage()">Send</button>
+
+  <script>
+    let sdk, chat;
+
+    async function init() {
+      sdk = new PlayKitSDK.PlayKitSDK({
+        gameId: 'your-game-id',
+        developerToken: 'your-dev-token'
+      });
+
+      await sdk.initialize();
+      chat = sdk.createChatClient();
+    }
+
+    async function sendMessage() {
+      const input = document.getElementById('userInput').value;
+      const output = document.getElementById('output');
+
+      output.innerHTML += `<p><strong>You:</strong> ${input}</p>`;
+      output.innerHTML += `<p><strong>AI:</strong> <span id="aiReply"></span></p>`;
+
+      const replyElement = document.getElementById('aiReply');
+      await chat.chatStream(
+        input,
+        (chunk) => { replyElement.innerHTML += chunk; }
+      );
+
+      document.getElementById('userInput').value = '';
+    }
+
+    init();
+  </script>
+</body>
+</html>
+```
+
+
+## License
+
+Proprietary License - see [LICENSE](LICENSE) file for details.
+
+This SDK is proprietary software owned by Agentland Lab. Use of this SDK is subject to the terms and conditions of the license agreement.
+
+## Support
+
+- Email: support@playkit.ai
+- Issues: [GitHub Issues](https://github.com/cnqdztp/PlayKit-JavascriptSDK/issues)
+
+## Changelog
+
+### 1.0.0-beta.1
+- Initial public beta release
+- AI chat support (text generation)
+- Image generation support
+- NPC conversation management
+- Authentication and player management
+- Streaming response support
+- Player balance management and recharge functionality