@arcadiasol/game-sdk 1.0.0

package/dist/esm/payment.d.ts

@@ -0,0 +1,26 @@
+import { PaymentResult } from './types';
+import { MessageHandler } from './messaging';
+import { WalletManager } from './wallet';
+/**
+ * Payment processing
+ */
+export declare class PaymentManager {
+    private gameId;
+    private isIframe;
+    private messageHandler;
+    private walletManager;
+    constructor(gameId: string, isIframe: boolean, messageHandler: MessageHandler, walletManager: WalletManager);
+    /**
+     * Pay to play - one-time payment to access game
+     */
+    payToPlay(amount: number, token: 'SOL' | 'USDC'): Promise<PaymentResult>;
+    /**
+     * Purchase in-game item
+     */
+    purchaseItem(itemId: string, amount: number, token: 'SOL' | 'USDC'): Promise<PaymentResult>;
+    /**
+     * Validate payment parameters
+     */
+    private validatePaymentParams;
+}
+//# sourceMappingURL=payment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../src/payment.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,aAAa,EAAmB,MAAM,SAAS,CAAC;AAQtF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAgB;gBAGnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,cAAc,EAAE,cAAc,EAC9B,aAAa,EAAE,aAAa;IAQ9B;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA6D9E;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkEjG;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAS9B"}

package/dist/esm/sdk.d.ts

@@ -0,0 +1,72 @@
+import { SDKConfig } from './types';
+/**
+ * Main Arcadia Game SDK class
+ */
+export declare class ArcadiaSDK {
+    private config;
+    private isIframe;
+    private initialized;
+    private messageHandler;
+    private walletManager;
+    private paymentManager;
+    /**
+     * Create new SDK instance
+     */
+    constructor(config: SDKConfig);
+    /**
+     * Initialize SDK and request initialization data from parent
+     */
+    init(): Promise<void>;
+    /**
+     * Get wallet address - use this as user identifier
+     * Games should link all save data to this wallet address
+     * Returns null if wallet not connected
+     */
+    getWalletAddress(): Promise<string | null>;
+    /**
+     * Check if wallet is connected
+     */
+    isWalletConnected(): Promise<boolean>;
+    /**
+     * Listen for wallet connection changes
+     */
+    onWalletChange(callback: (connected: boolean, address: string | null) => void): void;
+    /**
+     * Remove wallet change listener
+     */
+    offWalletChange(callback: (connected: boolean, address: string | null) => void): void;
+    /**
+     * Payment methods
+     */
+    get payment(): {
+        /**
+         * Pay to play - one-time payment to start/access game
+         */
+        payToPlay: (amount: number, token: "SOL" | "USDC") => Promise<import("./types").PaymentResult>;
+        /**
+         * In-game purchase - buy items, upgrades, etc.
+         */
+        purchaseItem: (itemId: string, amount: number, token: "SOL" | "USDC") => Promise<import("./types").PaymentResult>;
+    };
+    /**
+     * Get SDK configuration
+     */
+    getConfig(): SDKConfig;
+    /**
+     * Check if SDK is running in iframe
+     */
+    isInIframe(): boolean;
+    /**
+     * Check if SDK is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Cleanup SDK resources
+     */
+    destroy(): void;
+    /**
+     * Set up message listener for wallet updates
+     */
+    private setupMessageListener;
+}
+//# sourceMappingURL=sdk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqC,MAAM,SAAS,CAAC;AAMvE;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAiB;IAEvC;;OAEG;gBACS,MAAM,EAAE,SAAS;IAqC7B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC3B;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIhD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAI3C;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI;IAIpF;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI;IAIrF;;OAEG;IACH,IAAI,OAAO;QAEP;;WAEG;4BACiB,MAAM,SAAS,KAAK,GAAG,MAAM;QAIjD;;WAEG;+BACoB,MAAM,UAAU,MAAM,SAAS,KAAK,GAAG,MAAM;MAIvE;IAED;;OAEG;IACH,SAAS,IAAI,SAAS;IAItB;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAsB7B"}

package/dist/esm/types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * SDK Configuration
+ */
+export interface SDKConfig {
+    /** Unique game identifier */
+    gameId: string;
+    /** Optional: Parent window origin for security (defaults to '*' if not provided) */
+    parentOrigin?: string;
+    /** Optional: Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+/**
+ * Payment result
+ */
+export interface PaymentResult {
+    /** Whether payment was successful */
+    success: boolean;
+    /** Transaction signature on blockchain */
+    txSignature: string;
+    /** Amount paid by user */
+    amount: number;
+    /** Token type used for payment */
+    token: 'SOL' | 'USDC';
+    /** Timestamp when payment was completed (ISO string) */
+    timestamp: string;
+    /** Purchase ID from Arcadia database (for tracking/reference) */
+    purchaseId?: string;
+    /** Platform fee deducted (for transparency) */
+    platformFee?: number;
+    /** Amount received by developer (after platform fee) */
+    developerAmount?: number;
+    /** Optional error message if payment failed */
+    error?: string;
+}
+/**
+ * Wallet connection information
+ */
+export interface WalletInfo {
+    /** Whether wallet is connected */
+    connected: boolean;
+    /** Wallet address (public key) or null if not connected */
+    address: string | null;
+}
+/**
+ * Message types for postMessage communication
+ */
+export declare enum MessageType {
+    INIT_REQUEST = "INIT_REQUEST",
+    GET_WALLET_ADDRESS = "GET_WALLET_ADDRESS",
+    PAYMENT_REQUEST = "PAYMENT_REQUEST",
+    GAME_READY = "GAME_READY",
+    INIT = "INIT",
+    WALLET_ADDRESS_RESPONSE = "WALLET_ADDRESS_RESPONSE",
+    WALLET_UPDATE = "WALLET_UPDATE",
+    PAYMENT_RESPONSE = "PAYMENT_RESPONSE"
+}
+/**
+ * Payment request payload
+ */
+export interface PaymentRequest {
+    /** Payment amount */
+    amount: number;
+    /** Token type: 'SOL' or 'USDC' */
+    token: 'SOL' | 'USDC';
+    /** Payment type */
+    type: 'pay_to_play' | 'in_game_purchase';
+    /** Game ID */
+    gameId: string;
+    /** Optional: Item ID for in-game purchases */
+    itemId?: string;
+}
+/**
+ * Payment response payload
+ */
+export interface PaymentResponse {
+    /** Whether payment was successful */
+    success: boolean;
+    /** Transaction signature if successful */
+    txSignature?: string;
+    /** Amount paid by user */
+    amount?: number;
+    /** Token type used for payment */
+    token?: 'SOL' | 'USDC';
+    /** Timestamp when payment was completed (ISO string) */
+    timestamp?: string;
+    /** Purchase ID from Arcadia database (for tracking/reference) */
+    purchaseId?: string;
+    /** Platform fee deducted (for transparency) */
+    platformFee?: number;
+    /** Amount received by developer (after platform fee) */
+    developerAmount?: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Message envelope for postMessage
+ */
+export interface Message {
+    /** Message type */
+    type: MessageType | string;
+    /** Unique message ID for request/response matching */
+    id?: number;
+    /** Message payload */
+    payload?: any;
+}
+/**
+ * Initialization data from parent
+ */
+export interface InitData {
+    /** Game ID */
+    gameId: string;
+    /** User ID */
+    userId: string;
+    /** Wallet information */
+    wallet: WalletInfo;
+}
+/**
+ * Wallet address response
+ */
+export interface WalletAddressResponse {
+    /** Wallet address or null */
+    walletAddress: string | null;
+    /** Whether wallet is connected */
+    connected: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/esm/wallet.d.ts

@@ -0,0 +1,46 @@
+import { WalletInfo } from './types';
+import { MessageHandler } from './messaging';
+/**
+ * Wallet address management
+ */
+export declare class WalletManager {
+    private walletAddress;
+    private walletConnected;
+    private isIframe;
+    private messageHandler;
+    private walletChangeCallbacks;
+    constructor(messageHandler: MessageHandler, isIframe: boolean);
+    /**
+     * Get wallet address from parent window
+     */
+    getWalletAddress(): Promise<string | null>;
+    /**
+     * Check if wallet is connected
+     */
+    isWalletConnected(): Promise<boolean>;
+    /**
+     * Listen for wallet connection changes
+     */
+    onWalletChange(callback: (connected: boolean, address: string | null) => void): void;
+    /**
+     * Remove wallet change listener
+     */
+    offWalletChange(callback: (connected: boolean, address: string | null) => void): void;
+    /**
+     * Update wallet status (called by SDK when receiving WALLET_UPDATE message)
+     */
+    updateWalletStatus(walletInfo: WalletInfo): void;
+    /**
+     * Get current cached wallet address (without fetching)
+     */
+    getCachedWalletAddress(): string | null;
+    /**
+     * Get current cached connection status (without fetching)
+     */
+    getCachedConnectionStatus(): boolean;
+    /**
+     * Clear cached wallet data
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=wallet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,UAAU,EAAyB,MAAM,SAAS,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,qBAAqB,CAAmE;gBAEpF,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO;IAK7D;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAsBhD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAe3C;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI;IAIpF;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI;IAOrF;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAmBhD;;OAEG;IACH,sBAAsB,IAAI,MAAM,GAAG,IAAI;IAIvC;;OAEG;IACH,yBAAyB,IAAI,OAAO;IAIpC;;OAEG;IACH,UAAU,IAAI,IAAI;CAInB"}