@playcademy/sdk 0.0.1-beta.2 → 0.0.1-beta.21

package/dist/core/namespaces/runtime.d.ts

@@ -0,0 +1,45 @@
+import type { PlaycademyClient } from '../client';
+import type { GameTokenResponse } from '../../types';
+/**
+ * Creates the runtime namespace for the PlaycademyClient.
+ * Provides methods for managing game runtime operations and lifecycle.
+ *
+ * @param client - The PlaycademyClient instance
+ * @returns Runtime namespace with game token and exit methods
+ */
+export declare function createRuntimeNamespace(client: PlaycademyClient): {
+    /**
+     * Retrieves a game token for the specified game.
+     * Optionally applies the token to the current client instance.
+     *
+     * @param gameId - The ID of the game to get a token for
+     * @param options - Optional configuration
+     * @param options.apply - Whether to automatically apply the token to this client
+     * @returns Promise resolving to game token response
+     *
+     * @example
+     * ```typescript
+     * // Get token without applying it
+     * const tokenResponse = await client.runtime.getGameToken('game-123')
+     *
+     * // Get token and apply it to current client
+     * const tokenResponse = await client.runtime.getGameToken('game-123', { apply: true })
+     * ```
+     */
+    getGameToken: (gameId: string, options?: {
+        apply?: boolean;
+    }) => Promise<GameTokenResponse>;
+    /**
+     * Gracefully exits the game runtime.
+     * Automatically ends any active game session and emits an exit event.
+     *
+     * @returns Promise that resolves when exit is complete
+     *
+     * @example
+     * ```typescript
+     * // Clean up and exit the game
+     * await client.runtime.exit()
+     * ```
+     */
+    exit: () => Promise<void>;
+};

package/dist/core/namespaces/shop.d.ts

@@ -0,0 +1,26 @@
+import type { PlaycademyClient } from '../client';
+import type { ShopViewResponse } from '../../types';
+/**
+ * Creates the shop namespace for the PlaycademyClient.
+ * Provides methods for viewing shop listings and items available for purchase.
+ *
+ * @param client - The PlaycademyClient instance
+ * @returns Shop namespace with view methods
+ */
+export declare function createShopNamespace(client: PlaycademyClient): {
+    /**
+     * Retrieves the current shop view with available listings.
+     * Returns all items currently available for purchase in the shop.
+     *
+     * @returns Promise resolving to shop view data with listings
+     *
+     * @example
+     * ```typescript
+     * const shopData = await client.shop.view()
+     * shopData.listings.forEach(listing => {
+     *   console.log(`${listing.item.name}: ${listing.price} ${listing.currency.symbol}`)
+     * })
+     * ```
+     */
+    view: () => Promise<ShopViewResponse>;
+};

package/dist/core/namespaces/telemetry.d.ts

@@ -0,0 +1,28 @@
+import type { PlaycademyClient } from '../client';
+/**
+ * Creates the telemetry namespace for the PlaycademyClient.
+ * Provides methods for sending analytics and metrics data to the platform.
+ *
+ * @param client - The PlaycademyClient instance
+ * @returns Telemetry namespace with metrics methods
+ */
+export declare function createTelemetryNamespace(client: PlaycademyClient): {
+    /**
+     * Sends custom metrics data to the telemetry system.
+     * Useful for tracking game events, performance metrics, and analytics.
+     *
+     * @param metrics - Object containing metric names and their numeric values
+     * @returns Promise that resolves when metrics are successfully sent
+     *
+     * @example
+     * ```typescript
+     * await client.telemetry.pushMetrics({
+     *   'level_completed': 1,
+     *   'score': 1250,
+     *   'time_played_seconds': 180,
+     *   'enemies_defeated': 15
+     * })
+     * ```
+     */
+    pushMetrics: (metrics: Record<string, number>) => Promise<void>;
+};

package/dist/core/namespaces/users.d.ts

@@ -0,0 +1,84 @@
+import type { InventoryItemWithItem, InventoryMutationResponse } from '../../types';
+import type { PlaycademyClient } from '../client';
+/**
+ * Creates the users namespace for the PlaycademyClient.
+ * Provides methods for managing user data and inventory operations.
+ *
+ * @param client - The PlaycademyClient instance
+ * @returns Users namespace with user profile and inventory methods
+ */
+export declare function createUsersNamespace(client: PlaycademyClient): {
+    /**
+     * Retrieves the current user's profile information.
+     *
+     * @returns Promise resolving to user profile data
+     *
+     * @example
+     * ```typescript
+     * const user = await client.users.me()
+     * console.log('Username:', user.username)
+     * console.log('Email:', user.email)
+     * ```
+     */
+    me: () => Promise<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        name: string;
+        username: string | null;
+        email: string;
+        emailVerified: boolean;
+        image: string | null;
+        role: "admin" | "player" | "developer";
+        developerStatus: "none" | "pending" | "approved";
+    }>;
+    /**
+     * Inventory management methods for the current user.
+     */
+    inventory: {
+        /**
+         * Retrieves the user's complete inventory.
+         *
+         * @returns Promise resolving to array of inventory items with item details
+         *
+         * @example
+         * ```typescript
+         * const inventory = await client.users.inventory.get()
+         * inventory.forEach(item => {
+         *   console.log(`${item.item.name}: ${item.quantity}`)
+         * })
+         * ```
+         */
+        get: () => Promise<InventoryItemWithItem[]>;
+        /**
+         * Adds items to the user's inventory.
+         * Emits an 'inventoryChange' event when successful.
+         *
+         * @param itemId - The ID of the item to add
+         * @param qty - The quantity to add (must be positive)
+         * @returns Promise resolving to mutation response with new total
+         *
+         * @example
+         * ```typescript
+         * const result = await client.users.inventory.add('gold-coin', 100)
+         * console.log('New total:', result.newTotal)
+         * ```
+         */
+        add: (itemId: string, qty: number) => Promise<InventoryMutationResponse>;
+        /**
+         * Spends (removes) items from the user's inventory.
+         * Emits an 'inventoryChange' event when successful.
+         *
+         * @param itemId - The ID of the item to spend
+         * @param qty - The quantity to spend (must be positive)
+         * @returns Promise resolving to mutation response with new total
+         *
+         * @example
+         * ```typescript
+         * const result = await client.users.inventory.spend('health-potion', 1)
+         * console.log('Remaining potions:', result.newTotal)
+         * ```
+         */
+        spend: (itemId: string, qty: number) => Promise<InventoryMutationResponse>;
+    };
+};

package/dist/core/request.d.ts

@@ -1,4 +1,4 @@
-import { type ManifestV1 } from '@playcademy/data/schemas';
+import type { ManifestV1 } from '@playcademy/types';
 /** Permitted HTTP verbs */
 export type Method = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 export interface RequestOptions {

package/dist/core/static/index.d.ts

@@ -0,0 +1,2 @@
+export { init } from './init';
+export { login } from './login';

package/dist/core/static/init.d.ts

@@ -0,0 +1,21 @@
+import type { PlaycademyClient } from '../client';
+/**
+ * Auto-initializes a PlaycademyClient with context from the environment.
+ * Works in both iframe mode (production/development) and standalone mode (local dev).
+ *
+ * This is the recommended way to initialize the SDK as it automatically:
+ * - Detects the runtime environment (iframe vs standalone)
+ * - Configures the client with the appropriate context
+ * - Sets up event listeners for token refresh
+ * - Exposes the client for debugging in development mode
+ *
+ * @returns Promise resolving to a fully initialized PlaycademyClient
+ * @throws Error if not running in a browser context
+ *
+ * @example
+ * ```typescript
+ * const client = await PlaycademyClient.init()
+ * const user = await client.users.me()
+ * ```
+ */
+export declare function init(): Promise<PlaycademyClient>;

package/dist/core/static/login.d.ts

@@ -0,0 +1,24 @@
+import type { LoginResponse } from '../../types';
+/**
+ * Authenticates a user with email and password.
+ *
+ * This is a standalone authentication method that doesn't require an initialized client.
+ * Use this for login flows before creating a client instance.
+ *
+ * @param baseUrl - The base URL of the Playcademy API
+ * @param email - User's email address
+ * @param password - User's password
+ * @returns Promise resolving to authentication response with token
+ * @throws PlaycademyError if authentication fails or network error occurs
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const response = await PlaycademyClient.login('/api', 'user@example.com', 'password')
+ *   const client = new PlaycademyClient({ token: response.token })
+ * } catch (error) {
+ *   console.error('Login failed:', error.message)
+ * }
+ * ```
+ */
+export declare function login(baseUrl: string, email: string, password: string): Promise<LoginResponse>;

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Playcademy SDK - Main Entry Point
+ *
+ * This file serves as the primary entry point for the Playcademy SDK,
+ * providing access to the main client class and supporting utilities.
+ */
+export { PlaycademyClient } from './core/client';
+export { messaging, MessageEvents } from './messaging';
+export type * from './types';