@playcademy/sdk 0.0.1-beta.3 → 0.0.1-beta.5

package/src/runtime.ts

@@ -0,0 +1,61 @@
+import { bus, type BusEventMap, BusEvents } from './bus'
+import { PlaycademyClient } from './core/client'
+
+/** For Node, SSR, dashboards, etc. */
+export { PlaycademyClient } from './core/client'
+
+/** Factory for code running *inside* the CADEMY loader (games) */
+export async function initFromWindow(): Promise<PlaycademyClient> {
+    // ------------------------------------------------------------------
+    // 0.  Runtime guard
+    // ------------------------------------------------------------------
+    if (typeof window === 'undefined') {
+        throw new Error('initFromWindow must run in a browser context')
+    }
+
+    // ------------------------------------------------------------------
+    // 1.  Await bootstrap from loader (handles both module + iframe modes)
+    // ------------------------------------------------------------------
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const preloaded = (window as any).PLAYCADEMY as
+        | Partial<BusEventMap[BusEvents.INIT]>
+        | undefined
+
+    const config: BusEventMap[BusEvents.INIT] = preloaded?.token
+        ? (preloaded as BusEventMap[BusEvents.INIT])
+        : await new Promise<BusEventMap[BusEvents.INIT]>(resolve =>
+              bus.on(BusEvents.INIT, resolve),
+          )
+
+    // ------------------------------------------------------------------
+    // 2.  Spin up API client with the short‑lived Game‑JWT
+    // ------------------------------------------------------------------
+    const client = new PlaycademyClient({
+        baseUrl: config.baseUrl,
+        token: config.token,
+        gameId: config.gameId,
+    })
+
+    // ------------------------------------------------------------------
+    // 3.  React to runtime events automatically
+    // ------------------------------------------------------------------
+    bus.on(BusEvents.TOKEN_REFRESH, ({ token }) => client.setToken(token))
+
+    // ------------------------------------------------------------------
+    // 4.  Tell the parent loader we're alive
+    // ------------------------------------------------------------------
+    bus.emit(BusEvents.READY, undefined)
+
+    // ------------------------------------------------------------------
+    // (Expose for debugging if dev tools are open)
+    // ------------------------------------------------------------------
+    if (import.meta.env?.MODE === 'development') {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        ;(window as any).PLAYCADEMY_CLIENT = client
+    }
+
+    return client
+}
+
+export { bus, BusEvents } from './bus'
+export { PlaycademyError } from './core/errors'

package/src/types.ts

@@ -0,0 +1,55 @@
+import type {
+    User,
+    InventoryItemWithReward,
+    Game,
+    DeveloperKey,
+    DeveloperStatusResponse,
+    MapElement,
+    Reward,
+    InsertReward,
+    ManifestV1,
+    UpdateReward,
+} from '@playcademy/types'
+
+export interface ClientConfig {
+    baseUrl: string
+    token?: string
+    gameId?: string
+}
+
+export interface ClientEvents {
+    authChange: { token: string | null }
+    inventoryChange: { rewardId: string; delta: number; newTotal: number }
+}
+
+export type GameContextPayload = {
+    token: string
+    baseUrl: string
+    gameId: string
+}
+
+export type EventListeners = {
+    [E in keyof ClientEvents]?: Array<(payload: ClientEvents[E]) => void>
+}
+
+export type GameWithManifest = Game & { manifest: ManifestV1 }
+export type DeveloperStatusValue = DeveloperStatusResponse['status']
+export type GameState = Record<string, unknown>
+
+export type LoginResponse = { token: string }
+export type GameTokenResponse = { token: string; exp: number }
+export type StartSessionResponse = { sessionId: string }
+export type InventoryMutationResponse = { newTotal: number }
+
+export type {
+    User,
+    InventoryItemWithReward,
+    Game,
+    ManifestV1,
+    DeveloperKey,
+    DeveloperStatusResponse,
+    MapElement,
+    Reward,
+    InsertReward,
+    UpdateReward,
+}

package/sst-env.d.ts

@@ -0,0 +1,9 @@
+/* This file is auto-generated by SST. Do not edit. */
+/* tslint:disable */
+/* eslint-disable */
+/* deno-fmt-ignore-file */
+
+/// <reference path="../../sst-env.d.ts" />
+
+import "sst"
+export {}

package/tsconfig.json

@@ -0,0 +1,27 @@
+{
+    "compilerOptions": {
+        // Enable latest features
+        "lib": ["ESNext", "DOM"],
+        "target": "ESNext",
+        "module": "ESNext",
+        "moduleDetection": "force",
+        "jsx": "react-jsx",
+        "allowJs": true,
+
+        // Bundler mode
+        "moduleResolution": "bundler",
+        "allowImportingTsExtensions": true,
+        "verbatimModuleSyntax": true,
+        "noEmit": true,
+
+        // Best practices
+        "strict": true,
+        "skipLibCheck": true,
+        "noFallthroughCasesInSwitch": true,
+
+        // Some stricter flags (disabled by default)
+        "noUnusedLocals": false,
+        "noUnusedParameters": false,
+        "noPropertyAccessFromIndexSignature": false
+    }
+}

package/tsconfig.types.json

@@ -0,0 +1,13 @@
+{
+    "extends": "./tsconfig.json",
+    "compilerOptions": {
+        "noEmit": false,
+        "emitDeclarationOnly": true,
+        "declaration": true,
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "skipLibCheck": true
+    },
+    "include": ["src/**/*.ts"],
+    "exclude": ["node_modules", "**/*.test.ts"]
+}

package/dist/bus.d.ts

@@ -1,37 +0,0 @@
-import type { GameContextPayload } from './types';
-export declare enum BusEvents {
-    INIT = "PLAYCADEMY_INIT",
-    TOKEN_REFRESH = "PLAYCADEMY_TOKEN_REFRESH",
-    PAUSE = "PLAYCADEMY_PAUSE",
-    RESUME = "PLAYCADEMY_RESUME",
-    FORCE_EXIT = "PLAYCADEMY_FORCE_EXIT",
-    OVERLAY = "PLAYCADEMY_OVERLAY",
-    READY = "PLAYCADEMY_READY",
-    EXIT = "PLAYCADEMY_EXIT",
-    TELEMETRY = "PLAYCADEMY_TELEMETRY"
-}
-type BusHandler<T = unknown> = (payload: T) => void;
-export type BusEventMap = {
-    [BusEvents.INIT]: GameContextPayload;
-    [BusEvents.TOKEN_REFRESH]: {
-        token: string;
-        exp: number;
-    };
-    [BusEvents.PAUSE]: void;
-    [BusEvents.RESUME]: void;
-    [BusEvents.FORCE_EXIT]: void;
-    [BusEvents.OVERLAY]: boolean;
-    [BusEvents.READY]: void;
-    [BusEvents.EXIT]: void;
-    [BusEvents.TELEMETRY]: {
-        fps: number;
-        mem: number;
-    };
-};
-interface Bus {
-    emit<K extends BusEvents>(type: K, payload: BusEventMap[K]): void;
-    on<K extends BusEvents>(type: K, handler: BusHandler<BusEventMap[K]>): void;
-    off<K extends BusEvents>(type: K, handler: BusHandler<BusEventMap[K]>): void;
-}
-export declare const bus: Bus;
-export {};

package/dist/core/client.d.ts

@@ -1,144 +0,0 @@
-import { type Method } from './request';
-import { type Game, type GameWithManifest, type UpsertGameMetadataInput, type InsertReward, type UpdateReward } from '@playcademy/data/schemas';
-import type { GameState, InventoryItemWithReward, ClientConfig, ClientEvents, LoginResponse, GameTokenResponse, StartSessionResponse, InventoryMutationResponse, DeveloperStatusValue } from '../types';
-export declare class PlaycademyClient {
-    private baseUrl;
-    private token?;
-    private gameId?;
-    private listeners;
-    private internalClientSessionId?;
-    constructor(config: ClientConfig);
-    private _initializeInternalSession;
-    getBaseUrl(): string;
-    on<E extends keyof ClientEvents>(event: E, callback: (payload: ClientEvents[E]) => void): void;
-    private emit;
-    setToken(token: string | null): void;
-    onAuthChange(callback: (token: string | null) => void): void;
-    protected request<T>(path: string, method: Method, body?: unknown, headers?: Record<string, string>): Promise<T>;
-    private _ensureGameId;
-    auth: {
-        logout: () => Promise<void>;
-    };
-    runtime: {
-        getGameToken: (gameId: string, options?: {
-            apply?: boolean;
-        }) => Promise<GameTokenResponse>;
-        exit: () => Promise<void>;
-    };
-    games: {
-        fetch: (gameIdOrSlug: string) => Promise<GameWithManifest>;
-        list: () => Promise<Array<Game>>;
-        saveState: (state: Record<string, unknown>) => Promise<void>;
-        loadState: () => Promise<GameState>;
-        startSession: (gameId?: string) => Promise<StartSessionResponse>;
-        endSession: (sessionId: string, gameId?: string) => Promise<void>;
-    };
-    users: {
-        me: () => Promise<{
-            id: string;
-            name: string;
-            username: string | null;
-            email: string;
-            emailVerified: boolean;
-            image: string | null;
-            role: "admin" | "player" | "developer";
-            developerStatus: "none" | "pending" | "approved";
-            createdAt: Date;
-            updatedAt: Date;
-        }>;
-        inventory: {
-            get: () => Promise<InventoryItemWithReward[]>;
-            add: (rewardId: string, qty: number) => Promise<InventoryMutationResponse>;
-            spend: (rewardId: string, qty: number) => Promise<InventoryMutationResponse>;
-        };
-    };
-    dev: {
-        auth: {
-            applyForDeveloper: () => Promise<void>;
-            getDeveloperStatus: () => Promise<DeveloperStatusValue>;
-        };
-        games: {
-            upsert: (slug: string, metadata: UpsertGameMetadataInput, file: File | Blob) => Promise<Game>;
-            update: (gameId: string, props: Partial<Game>) => Promise<void>;
-            delete: (gameId: string) => Promise<void>;
-        };
-        keys: {
-            createKey: (gameId: string, label?: string) => Promise<{
-                id: string;
-                createdAt: Date;
-                userId: string;
-                label: string | null;
-                keyHash: string;
-            }>;
-            listKeys: (gameId: string) => Promise<{
-                id: string;
-                createdAt: Date;
-                userId: string;
-                label: string | null;
-                keyHash: string;
-            }[]>;
-            revokeKey: (keyId: string) => Promise<void>;
-        };
-    };
-    maps: {
-        elements: (mapId: string) => Promise<{
-            id: string;
-            mapId: string | null;
-            elementSlug: string;
-            interactionType: "game_entry" | "game_registry" | "info" | "teleport" | "door_in" | "door_out" | "npc_interaction" | "quest_trigger";
-            metadata: ({
-                description?: string | undefined;
-                sourceTiledObjects?: Record<string, unknown>[] | undefined;
-            } & {
-                [k: string]: unknown;
-            }) | null;
-            gameId: string | null;
-        }[]>;
-    };
-    admin: {
-        games: {
-            pauseGame: (gameId: string) => Promise<void>;
-            resumeGame: (gameId: string) => Promise<void>;
-        };
-        rewards: {
-            createReward: (props: InsertReward) => Promise<{
-                id: string;
-                type: "currency" | "badge" | "trophy" | "unlock" | "upgrade" | "other";
-                displayName: string;
-                description: string | null;
-                metadata: unknown;
-                internalName: string;
-            }>;
-            getReward: (rewardId: string) => Promise<{
-                id: string;
-                type: "currency" | "badge" | "trophy" | "unlock" | "upgrade" | "other";
-                displayName: string;
-                description: string | null;
-                metadata: unknown;
-                internalName: string;
-            }>;
-            listRewards: () => Promise<{
-                id: string;
-                type: "currency" | "badge" | "trophy" | "unlock" | "upgrade" | "other";
-                displayName: string;
-                description: string | null;
-                metadata: unknown;
-                internalName: string;
-            }[]>;
-            updateReward: (rewardId: string, props: UpdateReward) => Promise<{
-                id: string;
-                type: "currency" | "badge" | "trophy" | "unlock" | "upgrade" | "other";
-                displayName: string;
-                description: string | null;
-                metadata: unknown;
-                internalName: string;
-            }>;
-            deleteReward: (rewardId: string) => Promise<void>;
-        };
-    };
-    telemetry: {
-        pushMetrics: (metrics: Record<string, number>) => Promise<void>;
-    };
-    ping(): string;
-    static login(baseUrl: string, email: string, password: string): Promise<LoginResponse>;
-}

package/dist/core/errors.d.ts

@@ -1,11 +0,0 @@
-/**
- * Base error class for Cademy SDK specific errors.
- */
-export declare class PlaycademyError extends Error {
-    constructor(message: string);
-}
-export declare class ApiError extends Error {
-    status: number;
-    details: unknown;
-    constructor(status: number, message: string, details: unknown);
-}

package/dist/core/request.d.ts

@@ -1,24 +0,0 @@
-import { type ManifestV1 } from '@playcademy/data/schemas';
-/** Permitted HTTP verbs */
-export type Method = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
-export interface RequestOptions {
-    path: string;
-    baseUrl: string;
-    token?: string | null;
-    method?: Method;
-    body?: unknown;
-    extraHeaders?: Record<string, string>;
-}
-/**
- * Thin wrapper around `fetch` that:
- *  • attaches Bearer token if provided
- *  • stringifies JSON bodies and sets Content‑Type
- *  • passes FormData untouched so the browser adds multipart boundary
- *  • normalises non‑2xx responses into ApiError
- *  • auto‑parses JSON responses, falls back to text/void
- */
-export declare function request<T = unknown>({ path, baseUrl, token, method, body, extraHeaders, }: RequestOptions): Promise<T>;
-/**
- * Fetches, parses, and validates the playcademy.manifest.json file from a given base URL.
- */
-export declare function fetchManifest(assetBundleBase: string): Promise<ManifestV1>;

package/dist/runtime.d.ts

@@ -1,7 +0,0 @@
-import { PlaycademyClient } from './core/client';
-/** For Node, SSR, dashboards, etc. */
-export { PlaycademyClient } from './core/client';
-/** Factory for code running *inside* the CADEMY loader (games) */
-export declare function initFromWindow(): Promise<PlaycademyClient>;
-export { bus, BusEvents } from './bus';
-export { PlaycademyError } from './core/errors';