@arcadiasol/sdk 1.1.0

package/README.md

@@ -0,0 +1,139 @@
+# Arcadia Game SDK
+
+SDK for integrating Arcadia wallet and payment features into Web3 games.
+
+## Features
+
+- ✅ **Wallet Integration** - Get wallet address, check connection status
+- ✅ **Payment Processing** - Pay-to-play and in-game purchases
+- ✅ **Iframe Support** - Works seamlessly in Arcadia iframes
+- ✅ **Non-Iframe Support** - Works with direct API calls for native apps
+- ✅ **Stats Tracking** - Track playtime and online status (non-iframe mode)
+
+## Installation
+
+### NPM
+
+```bash
+npm install @arcadiasol/sdk
+```
+
+### CDN
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/@arcadiasol/sdk@latest/dist/umd/arcadia-game-sdk.js"></script>
+```
+
+## Quick Start
+
+### Iframe Mode (Web Games)
+
+```typescript
+import ArcadiaSDK from '@arcadiasol/sdk';
+
+const arcadia = new ArcadiaSDK({
+  gameId: 'your-game-id',
+});
+
+await arcadia.init();
+
+// Get wallet address
+const walletAddress = await arcadia.getWalletAddress();
+
+// Pay to play
+const result = await arcadia.payment.payToPlay(0.1, 'SOL');
+```
+
+### Non-Iframe Mode (Native Apps / External Games)
+
+```typescript
+import ArcadiaSDK from '@arcadiasol/sdk';
+
+const arcadia = new ArcadiaSDK({
+  gameId: 'your-game-id',
+  apiBaseURL: 'https://arcadia.com', // Required for non-iframe
+  authToken: 'your-auth-token', // Optional: if you have auth token
+  walletAddress: 'your-wallet-address', // Optional: if you know wallet address
+});
+
+await arcadia.init();
+
+// Get wallet address
+const walletAddress = await arcadia.getWalletAddress();
+
+// Track playtime
+await arcadia.stats.updatePlaytime(1.5, 'playing');
+
+// Update online status
+await arcadia.stats.updateOnlineStatus(true);
+
+// Pay to play (requires transaction signature)
+// Note: You must sign the transaction yourself in non-iframe mode
+const txSignature = await signTransaction(...); // Your signing logic
+const result = await arcadia.payment.payToPlay(0.1, 'SOL', txSignature);
+```
+
+## API Reference
+
+### Constructor
+
+```typescript
+new ArcadiaSDK(config: SDKConfig)
+```
+
+**Config Options:**
+- `gameId` (string, required) - Your game identifier
+- `parentOrigin` (string, optional) - Parent window origin for iframe security
+- `timeout` (number, optional) - Request timeout in milliseconds (default: 30000)
+- `apiBaseURL` (string, optional) - Base URL for API calls (required for non-iframe)
+- `authToken` (string, optional) - Pre-authenticated token (non-iframe mode)
+- `walletAddress` (string, optional) - Wallet address (non-iframe mode)
+
+### Methods
+
+#### `init(): Promise<void>`
+
+Initialize SDK. Must be called after creating SDK instance.
+
+#### `getWalletAddress(): Promise<string | null>`
+
+Get connected wallet address. Returns `null` if not connected.
+
+#### `isWalletConnected(): Promise<boolean>`
+
+Check if wallet is connected.
+
+#### `onWalletChange(callback: Function): void`
+
+Listen for wallet connection changes.
+
+#### `payment.payToPlay(amount, token, txSignature?)`
+
+Pay to play. `txSignature` required for non-iframe mode.
+
+#### `payment.purchaseItem(itemId, amount, token, txSignature?)`
+
+Purchase in-game item. `txSignature` required for non-iframe mode.
+
+#### `stats.updatePlaytime(hours, status?)`
+
+Update playtime (non-iframe mode only).
+
+#### `stats.updateOnlineStatus(isOnline)`
+
+Update online status (non-iframe mode only).
+
+## Environment Detection
+
+The SDK automatically detects if it's running in an iframe:
+
+- **Iframe Mode**: Uses `postMessage` for communication
+- **Non-Iframe Mode**: Uses REST API calls (requires `apiBaseURL`)
+
+## Examples
+
+See `/examples` directory for complete examples.
+
+## Documentation
+
+Full documentation: https://docs.arcadia.com/sdk

package/dist/esm/api-client.d.ts

@@ -0,0 +1,54 @@
+import { PaymentRequest, PaymentResponse, WalletAddressResponse } from './types';
+/**
+ * API Client for non-iframe environments
+ * Handles direct REST API calls when SDK is not running in iframe
+ */
+export declare class APIClient {
+    private baseURL;
+    private authToken;
+    private walletAddress;
+    constructor(baseURL?: string);
+    /**
+     * Detect Arcadia base URL from environment or use default
+     */
+    private detectBaseURL;
+    /**
+     * Set authentication token (from wallet authentication)
+     */
+    setAuthToken(token: string): void;
+    /**
+     * Set wallet address (for wallet-based auth)
+     */
+    setWalletAddress(address: string): void;
+    /**
+     * Authenticate with wallet
+     * Returns auth token for subsequent API calls
+     */
+    authenticateWithWallet(walletAddress: string, signature: string, message: string): Promise<{
+        token: string;
+        user: any;
+        profile: any;
+    }>;
+    /**
+     * Get wallet address (for non-iframe)
+     * Requires authentication
+     */
+    getWalletAddress(): Promise<WalletAddressResponse>;
+    /**
+     * Send payment request via API
+     */
+    sendPaymentRequest(gameId: string, request: PaymentRequest): Promise<PaymentResponse>;
+    /**
+     * Update playtime/stats
+     */
+    updatePlaytime(gameId: string, playtimeHours: number, status?: 'playing' | 'owned' | 'completed'): Promise<void>;
+    /**
+     * Update online status
+     */
+    updateOnlineStatus(isOnline: boolean, gameId?: string): Promise<void>;
+    /**
+     * Generic request method
+     */
+    private request;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/esm/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEjF;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,aAAa,CAAuB;gBAEhC,OAAO,CAAC,EAAE,MAAM;IAK5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIvC;;;OAGG;IACG,sBAAsB,CAC1B,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAE,CAAC;IAmBtD;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAuCxD;;OAEG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC;IAgB3B;;OAEG;IACG,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,GACzC,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;IACG,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3E;;OAEG;YACW,OAAO;CAgCtB"}

package/dist/esm/errors.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Base error class for all SDK errors
+ */
+export declare class ArcadiaSDKError extends Error {
+    code?: string | undefined;
+    constructor(message: string, code?: string | undefined);
+}
+/**
+ * Error thrown when wallet is not connected
+ */
+export declare class WalletNotConnectedError extends ArcadiaSDKError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when payment fails
+ */
+export declare class PaymentFailedError extends ArcadiaSDKError {
+    txSignature?: string | undefined;
+    constructor(message?: string, txSignature?: string | undefined);
+}
+/**
+ * Error thrown when request times out
+ */
+export declare class TimeoutError extends ArcadiaSDKError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when SDK configuration is invalid
+ */
+export declare class InvalidConfigError extends ArcadiaSDKError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when SDK is not running in iframe
+ */
+export declare class NotInIframeError extends ArcadiaSDKError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when invalid amount is provided
+ */
+export declare class InvalidAmountError extends ArcadiaSDKError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when invalid token is provided
+ */
+export declare class InvalidTokenError extends ArcadiaSDKError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACJ,IAAI,CAAC,EAAE,MAAM;gBAArC,OAAO,EAAE,MAAM,EAAS,IAAI,CAAC,EAAE,MAAM,YAAA;CAKlD;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,eAAe;gBAC9C,OAAO,GAAE,MAA0E;CAKhG;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;IACE,WAAW,CAAC,EAAE,MAAM;gBAA/D,OAAO,GAAE,MAAyB,EAAS,WAAW,CAAC,EAAE,MAAM,YAAA;CAK5E;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,eAAe;gBACnC,OAAO,GAAE,MAA+C;CAKrE;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;gBACzC,OAAO,GAAE,MAAoC;CAK1D;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;gBACvC,OAAO,GAAE,MAAiF;CAKvG;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;gBACzC,OAAO,GAAE,MAAiE;CAKvF;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;gBACxC,OAAO,GAAE,MAAkD;CAKxE"}

package/dist/esm/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Arcadia Game SDK
+ *
+ * SDK for integrating Arcadia wallet and payment features into Web3 games.
+ * Works in iframe environments by communicating with parent window via postMessage.
+ */
+export { ArcadiaSDK } from './sdk';
+export { APIClient } from './api-client';
+export type { SDKConfig, PaymentResult, WalletInfo, MessageType, PaymentRequest, PaymentResponse, InitData, WalletAddressResponse, } from './types';
+export { ArcadiaSDKError, WalletNotConnectedError, PaymentFailedError, TimeoutError, InvalidConfigError, NotInIframeError, InvalidAmountError, InvalidTokenError, } from './errors';
+import { ArcadiaSDK } from './sdk';
+export default ArcadiaSDK;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGnC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,YAAY,EACV,SAAS,EACT,aAAa,EACb,UAAU,EACV,WAAW,EACX,cAAc,EACd,eAAe,EACf,QAAQ,EACR,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,eAAe,UAAU,CAAC"}