@playcademy/sdk 0.3.6-beta.2 → 0.3.6-beta.4

package/dist/index.d.ts

@@ -7,21 +7,6 @@ import { AUTH_PROVIDER_IDS } from '@playcademy/constants';
 declare class PlaycademyError extends Error {
     constructor(message: string);
 }
-type CorsProbeResult = 'reachable' | 'unreachable' | 'skipped';
-interface ManifestErrorDetails {
-    manifestUrl: string;
-    manifestHost: string;
-    deploymentUrl: string;
-    fetchOutcome: 'network_error' | 'bad_status' | 'invalid_body';
-    retryCount: number;
-    durationMs: number;
-    fetchErrorMessage?: string;
-    corsProbe?: CorsProbeResult;
-    status?: number;
-    contentType?: string;
-    cfRay?: string;
-    redirected?: boolean;
-}
 /**
  * Error codes returned by the API.
  * These map to specific error types and HTTP status codes.
@@ -2330,4 +2315,4 @@ declare class PlaycademyMessaging {
 declare const messaging: PlaycademyMessaging;
 
 export { ApiError, ConnectionManager, ConnectionMonitor, MessageEvents, PlaycademyClient, PlaycademyError, extractApiErrorInfo, messaging };
-export type { ApiErrorCode, ApiErrorInfo, ConnectionMonitorConfig, ConnectionState, ConnectionStatePayload, DevUploadEvent, DevUploadHooks, DisconnectContext, DisconnectHandler, DisplayAlertPayload, ErrorResponseBody, ManifestErrorDetails };
+export type { ApiErrorCode, ApiErrorInfo, ConnectionMonitorConfig, ConnectionState, ConnectionStatePayload, DevUploadEvent, DevUploadHooks, DisconnectContext, DisconnectHandler, DisplayAlertPayload, ErrorResponseBody };

package/dist/index.js

@@ -407,18 +407,6 @@ class PlaycademyError extends Error {
   }
 }
 
-class ManifestError extends PlaycademyError {
-  kind;
-  details;
-  constructor(message, kind, details) {
-    super(message);
-    this.name = "ManifestError";
-    this.kind = kind;
-    this.details = details;
-    Object.setPrototypeOf(this, ManifestError.prototype);
-  }
-}
-
 class ApiError extends Error {
   code;
   details;
@@ -1972,98 +1960,6 @@ function unwrapFetchResult(result) {
   }
   return result.response;
 }
-// src/core/transport/manifest.ts
-var CORS_PROBE_TIMEOUT_MS = 3000;
-async function probeCorsReachability(url) {
-  if (typeof globalThis.AbortController === "undefined") {
-    return "skipped";
-  }
-  const controller = new AbortController;
-  const timer = setTimeout(() => controller.abort(), CORS_PROBE_TIMEOUT_MS);
-  try {
-    await fetch(url, {
-      mode: "no-cors",
-      cache: "no-store",
-      signal: controller.signal
-    });
-    return "reachable";
-  } catch {
-    return "unreachable";
-  } finally {
-    clearTimeout(timer);
-  }
-}
-var MAX_FETCH_ERROR_MESSAGE_LENGTH = 512;
-function getFetchErrorMessage(error) {
-  let raw;
-  if (error instanceof Error) {
-    raw = error.message;
-  } else if (typeof error === "string") {
-    raw = error;
-  }
-  if (!raw) {
-    return;
-  }
-  const normalized = raw.replace(/\s+/g, " ").trim();
-  if (!normalized) {
-    return;
-  }
-  return normalized.slice(0, MAX_FETCH_ERROR_MESSAGE_LENGTH);
-}
-async function fetchManifest(deploymentUrl) {
-  const manifestUrl = `${deploymentUrl.replace(/\/$/, "")}/playcademy.manifest.json`;
-  const result = await fetchWithRetry(manifestUrl, { method: "GET" });
-  let manifestHost;
-  try {
-    manifestHost = new URL(manifestUrl).host;
-  } catch {
-    manifestHost = manifestUrl;
-  }
-  const base = {
-    manifestUrl,
-    manifestHost,
-    deploymentUrl,
-    retryCount: result.retryCount,
-    durationMs: result.durationMs
-  };
-  if (result.error || !result.response) {
-    log.error(`[Playcademy SDK] Error fetching manifest from ${manifestUrl}:`, {
-      error: result.error
-    });
-    throw new ManifestError("Failed to load game manifest", "temporary", {
-      ...base,
-      fetchOutcome: "network_error",
-      ...result.error ? { fetchErrorMessage: getFetchErrorMessage(result.error) } : {}
-    });
-  }
-  const response = result.response;
-  if (!response.ok) {
-    log.error(`[fetchManifest] Failed to fetch manifest from ${manifestUrl}. Status: ${response.status}`);
-    throw new ManifestError(`Failed to fetch manifest: ${response.status} ${response.statusText}`, isRetryableStatus(response.status) ? "temporary" : "permanent", {
-      ...base,
-      fetchOutcome: "bad_status",
-      status: response.status,
-      contentType: response.headers.get("content-type") ?? undefined,
-      cfRay: response.headers.get("cf-ray") ?? undefined,
-      redirected: response.redirected
-    });
-  }
-  try {
-    return await response.json();
-  } catch (error) {
-    log.error(`[Playcademy SDK] Error parsing manifest from ${manifestUrl}:`, {
-      error
-    });
-    throw new ManifestError("Failed to parse game manifest", "permanent", {
-      ...base,
-      fetchOutcome: "invalid_body",
-      status: response.status,
-      contentType: response.headers.get("content-type") ?? undefined,
-      cfRay: response.headers.get("cf-ray") ?? undefined,
-      redirected: response.redirected
-    });
-  }
-}
 // src/core/transport/request.ts
 function prepareRequestBody(body, headers) {
   if (body instanceof FormData) {

package/dist/internal.d.ts

@@ -8,259 +8,6 @@ import { AUTH_PROVIDER_IDS } from '@playcademy/constants';
 /** Permitted HTTP verbs */
 type Method = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 
-/**
- * Game Types
- *
- * Literal types and API DTOs. Database row types are in @playcademy/data/types.
- *
- * @module types/game
- */
-type GameType = 'hosted' | 'external';
-type GamePlatform = 'web' | 'godot' | 'unity' | (string & {});
-/**
- * Game manifest file format (manifest.json).
- * Note: createdAt is a string here because it's parsed from JSON file.
- */
-interface ManifestV1 {
-    version: string;
-    platform: string;
-    createdAt: string;
-}
-/** Log entry captured from seed worker console output */
-interface SeedLogEntry {
-    /** Log level (log, warn, error, info) */
-    level: 'log' | 'warn' | 'error' | 'info';
-    /** Log message content */
-    message: string;
-    /** Milliseconds since seed execution started */
-    timestamp: number;
-}
-/** Structured error details from D1/SQLite errors */
-interface SeedErrorDetails {
-    /** Error category code */
-    code?: 'CONSTRAINT_VIOLATION' | 'SQL_ERROR' | 'DATABASE_BUSY';
-    /** Table name involved in the error */
-    table?: string;
-    /** Constraint name or column that caused the error */
-    constraint?: string;
-    /** Specific constraint type */
-    constraintType?: 'UNIQUE' | 'FOREIGN_KEY' | 'NOT_NULL';
-    /** Token near syntax error */
-    nearToken?: string;
-    /** Specific error type within category */
-    errorType?: 'TABLE_NOT_FOUND' | 'SYNTAX_ERROR';
-}
-/**
- * API response for seed operations (what the API returns to the CLI).
- *
- * Extends the worker response with deployment metadata.
- */
-interface SeedResponse {
-    /** Whether the seed completed successfully */
-    success: boolean;
-    /** Unique identifier for the seed worker deployment */
-    deploymentId: string;
-    /** When the seed was executed (ISO 8601 string from JSON serialization) */
-    executedAt: string;
-    /** Captured console output from the seed script */
-    logs?: SeedLogEntry[];
-    /** Execution duration in milliseconds */
-    duration?: number;
-    /** Error message if seed failed */
-    error?: string;
-    /** Stack trace if seed failed */
-    stack?: string;
-    /** Structured error details if seed failed */
-    details?: SeedErrorDetails;
-}
-interface DomainValidationRecords {
-    ownership?: {
-        name?: string;
-        value?: string;
-        type?: string;
-    };
-    ssl?: {
-        txt_name?: string;
-        txt_value?: string;
-    }[];
-}
-
-/**
- * Base error class for Cademy SDK specific errors.
- */
-declare class PlaycademyError extends Error {
-    constructor(message: string);
-}
-type ManifestErrorKind = 'temporary' | 'permanent';
-type CorsProbeResult = 'reachable' | 'unreachable' | 'skipped';
-interface ManifestErrorDetails {
-    manifestUrl: string;
-    manifestHost: string;
-    deploymentUrl: string;
-    fetchOutcome: 'network_error' | 'bad_status' | 'invalid_body';
-    retryCount: number;
-    durationMs: number;
-    fetchErrorMessage?: string;
-    corsProbe?: CorsProbeResult;
-    status?: number;
-    contentType?: string;
-    cfRay?: string;
-    redirected?: boolean;
-}
-declare class ManifestError extends PlaycademyError {
-    readonly kind: ManifestErrorKind;
-    readonly details: ManifestErrorDetails | undefined;
-    constructor(message: string, kind: ManifestErrorKind, details?: ManifestErrorDetails);
-}
-/**
- * Error codes returned by the API.
- * These map to specific error types and HTTP status codes.
- */
-type ApiErrorCode = 'BAD_REQUEST' | 'UNAUTHORIZED' | 'FORBIDDEN' | 'ACCESS_DENIED' | 'NOT_FOUND' | 'METHOD_NOT_ALLOWED' | 'CONFLICT' | 'ALREADY_EXISTS' | 'GONE' | 'PRECONDITION_FAILED' | 'PAYLOAD_TOO_LARGE' | 'VALIDATION_FAILED' | 'TOO_MANY_REQUESTS' | 'RATE_LIMITED' | 'EXPIRED' | 'INTERNAL' | 'INTERNAL_ERROR' | 'NOT_IMPLEMENTED' | 'SERVICE_UNAVAILABLE' | 'TIMEOUT' | string;
-/**
- * Structure of error response bodies returned by API endpoints.
- *
- * @example
- * ```json
- * {
- *   "error": {
- *     "code": "NOT_FOUND",
- *     "message": "Item not found",
- *     "details": { "identifier": "abc123" }
- *   }
- * }
- * ```
- */
-interface ErrorResponseBody {
-    error?: {
-        code?: string;
-        message?: string;
-        details?: unknown;
-    };
-}
-/**
- * API error thrown when a request fails.
- *
- * Contains structured error information from the API response:
- * - `status` - HTTP status code (e.g., 404)
- * - `code` - API error code (e.g., "NOT_FOUND")
- * - `message` - Human-readable error message
- * - `details` - Optional additional error context
- *
- * @example
- * ```typescript
- * try {
- *   await client.games.get('nonexistent')
- * } catch (error) {
- *   if (error instanceof ApiError) {
- *     console.log(error.status)   // 404
- *     console.log(error.code)     // "NOT_FOUND"
- *     console.log(error.message)  // "Game not found"
- *     console.log(error.details)  // { identifier: "nonexistent" }
- *   }
- * }
- * ```
- */
-declare class ApiError extends Error {
-    /**
-     * API error code (e.g., "NOT_FOUND", "VALIDATION_FAILED").
-     * Use this for programmatic error handling.
-     */
-    readonly code: ApiErrorCode;
-    /**
-     * Additional error context from the API.
-     * Structure varies by error type (e.g., validation errors include field details).
-     */
-    readonly details: unknown;
-    /**
-     * Raw response body for debugging.
-     * @internal
-     */
-    readonly rawBody: unknown;
-    readonly status: number;
-    constructor(
-    /** HTTP status code */
-    status: number, 
-    /** API error code */
-    code: ApiErrorCode, 
-    /** Human-readable error message */
-    message: string, 
-    /** Additional error context */
-    details?: unknown, 
-    /** Raw response body */
-    rawBody?: unknown);
-    /**
-     * Create an ApiError from an HTTP response.
-     * Parses the structured error response from the API.
-     *
-     * @internal
-     */
-    static fromResponse(status: number, statusText: string, body: unknown): ApiError;
-    /**
-     * Check if this is a specific error type.
-     *
-     * @example
-     * ```typescript
-     * if (error.is('NOT_FOUND')) {
-     *   // Handle not found
-     * } else if (error.is('VALIDATION_FAILED')) {
-     *   // Handle validation error
-     * }
-     * ```
-     */
-    is(code: ApiErrorCode): boolean;
-    /**
-     * Check if this is a client error (4xx).
-     */
-    isClientError(): boolean;
-    /**
-     * Check if this is a server error (5xx).
-     */
-    isServerError(): boolean;
-    /**
-     * Check if this error is retryable.
-     * Server errors and rate limits are typically retryable.
-     */
-    isRetryable(): boolean;
-}
-/**
- * Extracted error information for display purposes.
- */
-interface ApiErrorInfo {
-    /** HTTP status code */
-    status: number;
-    /** API error code */
-    code: ApiErrorCode;
-    /** Human-readable error message */
-    message: string;
-    /** Additional error context */
-    details?: unknown;
-}
-/**
- * Extract useful error information from an API error.
- * Useful for displaying errors to users in a friendly way.
- *
- * @example
- * ```typescript
- * try {
- *   await client.shop.purchase(itemId)
- * } catch (error) {
- *   const info = extractApiErrorInfo(error)
- *   if (info) {
- *     showToast(`Error: ${info.message}`)
- *   }
- * }
- * ```
- */
-declare function extractApiErrorInfo(error: unknown): ApiErrorInfo | null;
-
-/**
- * Fire-and-forget reachability check using `no-cors` mode.
- * Exported for use by the app telemetry layer — not awaited inside
- * fetchManifest so it doesn't block the error screen.
- */
-declare function probeCorsReachability(url: string): Promise<CorsProbeResult>;
-
 /**
  * User Types
  *
@@ -341,6 +88,83 @@ interface GameUser {
     timeback?: UserTimebackData;
 }
 
+/**
+ * Game Types
+ *
+ * Literal types and API DTOs. Database row types are in @playcademy/data/types.
+ *
+ * @module types/game
+ */
+type GameType = 'hosted' | 'external';
+type GamePlatform = 'web' | 'godot' | 'unity' | (string & {});
+/**
+ * Game manifest file format (manifest.json).
+ * Note: createdAt is a string here because it's parsed from JSON file.
+ */
+interface ManifestV1 {
+    version: string;
+    platform: string;
+    createdAt: string;
+}
+/** Log entry captured from seed worker console output */
+interface SeedLogEntry {
+    /** Log level (log, warn, error, info) */
+    level: 'log' | 'warn' | 'error' | 'info';
+    /** Log message content */
+    message: string;
+    /** Milliseconds since seed execution started */
+    timestamp: number;
+}
+/** Structured error details from D1/SQLite errors */
+interface SeedErrorDetails {
+    /** Error category code */
+    code?: 'CONSTRAINT_VIOLATION' | 'SQL_ERROR' | 'DATABASE_BUSY';
+    /** Table name involved in the error */
+    table?: string;
+    /** Constraint name or column that caused the error */
+    constraint?: string;
+    /** Specific constraint type */
+    constraintType?: 'UNIQUE' | 'FOREIGN_KEY' | 'NOT_NULL';
+    /** Token near syntax error */
+    nearToken?: string;
+    /** Specific error type within category */
+    errorType?: 'TABLE_NOT_FOUND' | 'SYNTAX_ERROR';
+}
+/**
+ * API response for seed operations (what the API returns to the CLI).
+ *
+ * Extends the worker response with deployment metadata.
+ */
+interface SeedResponse {
+    /** Whether the seed completed successfully */
+    success: boolean;
+    /** Unique identifier for the seed worker deployment */
+    deploymentId: string;
+    /** When the seed was executed (ISO 8601 string from JSON serialization) */
+    executedAt: string;
+    /** Captured console output from the seed script */
+    logs?: SeedLogEntry[];
+    /** Execution duration in milliseconds */
+    duration?: number;
+    /** Error message if seed failed */
+    error?: string;
+    /** Stack trace if seed failed */
+    stack?: string;
+    /** Structured error details if seed failed */
+    details?: SeedErrorDetails;
+}
+interface DomainValidationRecords {
+    ownership?: {
+        name?: string;
+        value?: string;
+        type?: string;
+    };
+    ssl?: {
+        txt_name?: string;
+        txt_value?: string;
+    }[];
+}
+
 /**
  * Leaderboard Types
  *
@@ -915,7 +739,7 @@ interface TimebackStudentCourseOverview {
     completionStatus: CourseCompletionStatus;
     history: TimebackStudentHistoryPoint[];
 }
-type TimebackRecentActivityKind = 'activity' | 'time-spent' | 'remediation-xp' | 'remediation-time' | 'remediation-mastery' | 'admin-completion';
+type TimebackRecentActivityKind = 'activity' | 'time-spent' | 'remediation-xp' | 'remediation-time' | 'remediation-mastery' | 'course-completed' | 'course-resumed';
 interface TimebackRecentActivity {
     id: string;
     kind: TimebackRecentActivityKind;
@@ -1222,6 +1046,154 @@ interface SpriteConfigWithDimensions {
     animations: Record<string, SpriteAnimationFrame>;
 }
 
+/**
+ * Base error class for Cademy SDK specific errors.
+ */
+declare class PlaycademyError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error codes returned by the API.
+ * These map to specific error types and HTTP status codes.
+ */
+type ApiErrorCode = 'BAD_REQUEST' | 'UNAUTHORIZED' | 'FORBIDDEN' | 'ACCESS_DENIED' | 'NOT_FOUND' | 'METHOD_NOT_ALLOWED' | 'CONFLICT' | 'ALREADY_EXISTS' | 'GONE' | 'PRECONDITION_FAILED' | 'PAYLOAD_TOO_LARGE' | 'VALIDATION_FAILED' | 'TOO_MANY_REQUESTS' | 'RATE_LIMITED' | 'EXPIRED' | 'INTERNAL' | 'INTERNAL_ERROR' | 'NOT_IMPLEMENTED' | 'SERVICE_UNAVAILABLE' | 'TIMEOUT' | string;
+/**
+ * Structure of error response bodies returned by API endpoints.
+ *
+ * @example
+ * ```json
+ * {
+ *   "error": {
+ *     "code": "NOT_FOUND",
+ *     "message": "Item not found",
+ *     "details": { "identifier": "abc123" }
+ *   }
+ * }
+ * ```
+ */
+interface ErrorResponseBody {
+    error?: {
+        code?: string;
+        message?: string;
+        details?: unknown;
+    };
+}
+/**
+ * API error thrown when a request fails.
+ *
+ * Contains structured error information from the API response:
+ * - `status` - HTTP status code (e.g., 404)
+ * - `code` - API error code (e.g., "NOT_FOUND")
+ * - `message` - Human-readable error message
+ * - `details` - Optional additional error context
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.games.get('nonexistent')
+ * } catch (error) {
+ *   if (error instanceof ApiError) {
+ *     console.log(error.status)   // 404
+ *     console.log(error.code)     // "NOT_FOUND"
+ *     console.log(error.message)  // "Game not found"
+ *     console.log(error.details)  // { identifier: "nonexistent" }
+ *   }
+ * }
+ * ```
+ */
+declare class ApiError extends Error {
+    /**
+     * API error code (e.g., "NOT_FOUND", "VALIDATION_FAILED").
+     * Use this for programmatic error handling.
+     */
+    readonly code: ApiErrorCode;
+    /**
+     * Additional error context from the API.
+     * Structure varies by error type (e.g., validation errors include field details).
+     */
+    readonly details: unknown;
+    /**
+     * Raw response body for debugging.
+     * @internal
+     */
+    readonly rawBody: unknown;
+    readonly status: number;
+    constructor(
+    /** HTTP status code */
+    status: number, 
+    /** API error code */
+    code: ApiErrorCode, 
+    /** Human-readable error message */
+    message: string, 
+    /** Additional error context */
+    details?: unknown, 
+    /** Raw response body */
+    rawBody?: unknown);
+    /**
+     * Create an ApiError from an HTTP response.
+     * Parses the structured error response from the API.
+     *
+     * @internal
+     */
+    static fromResponse(status: number, statusText: string, body: unknown): ApiError;
+    /**
+     * Check if this is a specific error type.
+     *
+     * @example
+     * ```typescript
+     * if (error.is('NOT_FOUND')) {
+     *   // Handle not found
+     * } else if (error.is('VALIDATION_FAILED')) {
+     *   // Handle validation error
+     * }
+     * ```
+     */
+    is(code: ApiErrorCode): boolean;
+    /**
+     * Check if this is a client error (4xx).
+     */
+    isClientError(): boolean;
+    /**
+     * Check if this is a server error (5xx).
+     */
+    isServerError(): boolean;
+    /**
+     * Check if this error is retryable.
+     * Server errors and rate limits are typically retryable.
+     */
+    isRetryable(): boolean;
+}
+/**
+ * Extracted error information for display purposes.
+ */
+interface ApiErrorInfo {
+    /** HTTP status code */
+    status: number;
+    /** API error code */
+    code: ApiErrorCode;
+    /** Human-readable error message */
+    message: string;
+    /** Additional error context */
+    details?: unknown;
+}
+/**
+ * Extract useful error information from an API error.
+ * Useful for displaying errors to users in a friendly way.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.shop.purchase(itemId)
+ * } catch (error) {
+ *   const info = extractApiErrorInfo(error)
+ *   if (info) {
+ *     showToast(`Error: ${info.message}`)
+ *   }
+ * }
+ * ```
+ */
+declare function extractApiErrorInfo(error: unknown): ApiErrorInfo | null;
+
 /**
  * Connection monitoring types
  *
@@ -7787,5 +7759,5 @@ declare class PlaycademyInternalClient extends PlaycademyBaseClient {
     };
 }
 
-export { AchievementCompletionType, ApiError, ConnectionManager, ConnectionMonitor, ManifestError, MessageEvents, NotificationStatus, NotificationType, PlaycademyInternalClient as PlaycademyClient, PlaycademyError, PlaycademyInternalClient, extractApiErrorInfo, messaging, probeCorsReachability };
-export type { AchievementCurrent, AchievementHistoryEntry, AchievementProgressResponse, AchievementScopeType, AchievementWithStatus, ApiErrorCode, ApiErrorInfo, AuthCallbackPayload, AuthOptions, AuthProviderType, AuthResult, AuthServerMessage, AuthStateChangePayload, AuthStateUpdate, AuthenticatedUser, BetterAuthApiKey, BetterAuthApiKeyResponse, BetterAuthSignInResponse, BucketFile, CharacterComponentRow as CharacterComponent, CharacterComponentType, CharacterComponentWithSpriteUrl, CharacterComponentsOptions, ClientConfig, ClientEvents, ConnectionMonitorConfig, ConnectionState, ConnectionStatePayload, CorsProbeResult, CourseXp, CreateCharacterData, CreateMapObjectData, CurrencyRow as Currency, DevUploadEvent, DevUploadHooks, DeveloperStatusEnumType, DeveloperStatusResponse, DeveloperStatusValue, DisconnectContext, DisconnectHandler, DisplayAlertPayload, ErrorResponseBody, EventListeners, ExternalGame, FetchedGame, Game, GameContextPayload, GameCustomHostname, GameInitUser, GameLeaderboardEntry, MapRow as GameMap, GamePlatform, GameRow as GameRecord, GameSessionRow as GameSession, GameTimebackIntegration, GameTokenResponse, GameType, GameUser, GetXpOptions, HostedGame, InitPayload, InsertCurrencyInput, InsertItemInput, InsertShopListingInput, InteractionType, InventoryItemRow as InventoryItem, InventoryItemWithItem, InventoryMutationResponse, ItemRow as Item, ItemType, KVKeyEntry, KVKeyMetadata, KVSeedEntry, KVStatsResponse, KeyEventPayload, LeaderboardEntry, LeaderboardOptions, LeaderboardTimeframe, LevelConfigRow as LevelConfig, LevelProgressResponse, LevelUpCheckResult, LoginResponse, ManifestErrorDetails, ManifestV1, MapData, MapElementRow as MapElement, MapElementMetadata, MapElementWithGame, MapObjectRow as MapObject, MapObjectWithItem, NotificationRow as Notification, NotificationStats, PlaceableItemMetadata, PlatformTimebackUser, PlatformTimebackUserContext, PlaycademyServerClientConfig, PlaycademyServerClientState, PlayerCharacterRow as PlayerCharacter, PlayerCharacterAccessoryRow as PlayerCharacterAccessory, PlayerCurrency, PlayerInventoryItem, PlayerProfile, PlayerSessionPayload, PopulateStudentResponse, RealtimeTokenResponse, ScoreSubmission, ShopCurrency, ShopDisplayItem, ShopListingRow as ShopListing, ShopViewResponse, SpriteAnimationFrame, SpriteConfigWithDimensions, SpriteTemplateRow as SpriteTemplate, SpriteTemplateData, StartSessionResponse, TelemetryPayload, TimebackEnrollment, TimebackInitContext, TimebackOrganization, TimebackUser, TimebackUserContext, TimebackUserXp, TodayXpResponse, TokenRefreshPayload, TokenType, TotalXpResponse, UpdateCharacterData, UpdateCurrencyInput, UpdateItemInput, UpdateShopListingInput, UpsertGameMetadataInput, UserRow as User, UserEnrollment, UserInfo, UserLevelRow as UserLevel, UserLevelWithConfig, UserOrganization, UserRank, UserRankResponse, UserRoleEnumType, UserScore, UserTimebackData, XPAddResult, XpHistoryResponse, XpResponse, XpSummaryResponse };
+export { AchievementCompletionType, ApiError, ConnectionManager, ConnectionMonitor, MessageEvents, NotificationStatus, NotificationType, PlaycademyInternalClient as PlaycademyClient, PlaycademyError, PlaycademyInternalClient, extractApiErrorInfo, messaging };
+export type { AchievementCurrent, AchievementHistoryEntry, AchievementProgressResponse, AchievementScopeType, AchievementWithStatus, ApiErrorCode, ApiErrorInfo, AuthCallbackPayload, AuthOptions, AuthProviderType, AuthResult, AuthServerMessage, AuthStateChangePayload, AuthStateUpdate, AuthenticatedUser, BetterAuthApiKey, BetterAuthApiKeyResponse, BetterAuthSignInResponse, BucketFile, CharacterComponentRow as CharacterComponent, CharacterComponentType, CharacterComponentWithSpriteUrl, CharacterComponentsOptions, ClientConfig, ClientEvents, ConnectionMonitorConfig, ConnectionState, ConnectionStatePayload, CourseXp, CreateCharacterData, CreateMapObjectData, CurrencyRow as Currency, DevUploadEvent, DevUploadHooks, DeveloperStatusEnumType, DeveloperStatusResponse, DeveloperStatusValue, DisconnectContext, DisconnectHandler, DisplayAlertPayload, ErrorResponseBody, EventListeners, ExternalGame, FetchedGame, Game, GameContextPayload, GameCustomHostname, GameInitUser, GameLeaderboardEntry, MapRow as GameMap, GamePlatform, GameRow as GameRecord, GameSessionRow as GameSession, GameTimebackIntegration, GameTokenResponse, GameType, GameUser, GetXpOptions, HostedGame, InitPayload, InsertCurrencyInput, InsertItemInput, InsertShopListingInput, InteractionType, InventoryItemRow as InventoryItem, InventoryItemWithItem, InventoryMutationResponse, ItemRow as Item, ItemType, KVKeyEntry, KVKeyMetadata, KVSeedEntry, KVStatsResponse, KeyEventPayload, LeaderboardEntry, LeaderboardOptions, LeaderboardTimeframe, LevelConfigRow as LevelConfig, LevelProgressResponse, LevelUpCheckResult, LoginResponse, ManifestV1, MapData, MapElementRow as MapElement, MapElementMetadata, MapElementWithGame, MapObjectRow as MapObject, MapObjectWithItem, NotificationRow as Notification, NotificationStats, PlaceableItemMetadata, PlatformTimebackUser, PlatformTimebackUserContext, PlaycademyServerClientConfig, PlaycademyServerClientState, PlayerCharacterRow as PlayerCharacter, PlayerCharacterAccessoryRow as PlayerCharacterAccessory, PlayerCurrency, PlayerInventoryItem, PlayerProfile, PlayerSessionPayload, PopulateStudentResponse, RealtimeTokenResponse, ScoreSubmission, ShopCurrency, ShopDisplayItem, ShopListingRow as ShopListing, ShopViewResponse, SpriteAnimationFrame, SpriteConfigWithDimensions, SpriteTemplateRow as SpriteTemplate, SpriteTemplateData, StartSessionResponse, TelemetryPayload, TimebackEnrollment, TimebackInitContext, TimebackOrganization, TimebackUser, TimebackUserContext, TimebackUserXp, TodayXpResponse, TokenRefreshPayload, TokenType, TotalXpResponse, UpdateCharacterData, UpdateCurrencyInput, UpdateItemInput, UpdateShopListingInput, UpsertGameMetadataInput, UserRow as User, UserEnrollment, UserInfo, UserLevelRow as UserLevel, UserLevelWithConfig, UserOrganization, UserRank, UserRankResponse, UserRoleEnumType, UserScore, UserTimebackData, XPAddResult, XpHistoryResponse, XpResponse, XpSummaryResponse };

package/dist/internal.js

@@ -407,18 +407,6 @@ class PlaycademyError extends Error {
   }
 }
 
-class ManifestError extends PlaycademyError {
-  kind;
-  details;
-  constructor(message, kind, details) {
-    super(message);
-    this.name = "ManifestError";
-    this.kind = kind;
-    this.details = details;
-    Object.setPrototypeOf(this, ManifestError.prototype);
-  }
-}
-
 class ApiError extends Error {
   code;
   details;
@@ -2039,235 +2027,6 @@ function createDevNamespace(client) {
     }
   };
 }
-// src/core/transport/retry.ts
-var RETRY_DELAYS_MS = [500, 1500];
-function wait(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-var retryRuntime = { wait };
-function isRetryableStatus(status) {
-  return status === 429 || status >= 500;
-}
-async function fetchWithRetry(url, init2) {
-  const startedAt = Date.now();
-  for (let attempt = 0;attempt <= RETRY_DELAYS_MS.length; attempt++) {
-    const retryDelayMs = RETRY_DELAYS_MS[attempt];
-    const canRetry = init2.method === "GET" && retryDelayMs !== undefined;
-    try {
-      const response = await fetch(url, init2);
-      if (canRetry && isRetryableStatus(response.status)) {
-        await retryRuntime.wait(retryDelayMs);
-      } else {
-        return { response, retryCount: attempt, durationMs: Date.now() - startedAt };
-      }
-    } catch (error) {
-      if (canRetry && error instanceof TypeError) {
-        await retryRuntime.wait(retryDelayMs);
-      } else {
-        return { error, retryCount: attempt, durationMs: Date.now() - startedAt };
-      }
-    }
-  }
-  return {
-    error: new PlaycademyError("Request failed after exhausting retries"),
-    retryCount: RETRY_DELAYS_MS.length,
-    durationMs: Date.now() - startedAt
-  };
-}
-function unwrapFetchResult(result) {
-  if (result.error) {
-    throw result.error;
-  }
-  if (!result.response) {
-    throw new PlaycademyError("Request failed after exhausting retries");
-  }
-  return result.response;
-}
-// src/core/transport/manifest.ts
-var CORS_PROBE_TIMEOUT_MS = 3000;
-async function probeCorsReachability(url) {
-  if (typeof globalThis.AbortController === "undefined") {
-    return "skipped";
-  }
-  const controller = new AbortController;
-  const timer = setTimeout(() => controller.abort(), CORS_PROBE_TIMEOUT_MS);
-  try {
-    await fetch(url, {
-      mode: "no-cors",
-      cache: "no-store",
-      signal: controller.signal
-    });
-    return "reachable";
-  } catch {
-    return "unreachable";
-  } finally {
-    clearTimeout(timer);
-  }
-}
-var MAX_FETCH_ERROR_MESSAGE_LENGTH = 512;
-function getFetchErrorMessage(error) {
-  let raw;
-  if (error instanceof Error) {
-    raw = error.message;
-  } else if (typeof error === "string") {
-    raw = error;
-  }
-  if (!raw) {
-    return;
-  }
-  const normalized = raw.replace(/\s+/g, " ").trim();
-  if (!normalized) {
-    return;
-  }
-  return normalized.slice(0, MAX_FETCH_ERROR_MESSAGE_LENGTH);
-}
-async function fetchManifest(deploymentUrl) {
-  const manifestUrl = `${deploymentUrl.replace(/\/$/, "")}/playcademy.manifest.json`;
-  const result = await fetchWithRetry(manifestUrl, { method: "GET" });
-  let manifestHost;
-  try {
-    manifestHost = new URL(manifestUrl).host;
-  } catch {
-    manifestHost = manifestUrl;
-  }
-  const base = {
-    manifestUrl,
-    manifestHost,
-    deploymentUrl,
-    retryCount: result.retryCount,
-    durationMs: result.durationMs
-  };
-  if (result.error || !result.response) {
-    log.error(`[Playcademy SDK] Error fetching manifest from ${manifestUrl}:`, {
-      error: result.error
-    });
-    throw new ManifestError("Failed to load game manifest", "temporary", {
-      ...base,
-      fetchOutcome: "network_error",
-      ...result.error ? { fetchErrorMessage: getFetchErrorMessage(result.error) } : {}
-    });
-  }
-  const response = result.response;
-  if (!response.ok) {
-    log.error(`[fetchManifest] Failed to fetch manifest from ${manifestUrl}. Status: ${response.status}`);
-    throw new ManifestError(`Failed to fetch manifest: ${response.status} ${response.statusText}`, isRetryableStatus(response.status) ? "temporary" : "permanent", {
-      ...base,
-      fetchOutcome: "bad_status",
-      status: response.status,
-      contentType: response.headers.get("content-type") ?? undefined,
-      cfRay: response.headers.get("cf-ray") ?? undefined,
-      redirected: response.redirected
-    });
-  }
-  try {
-    return await response.json();
-  } catch (error) {
-    log.error(`[Playcademy SDK] Error parsing manifest from ${manifestUrl}:`, {
-      error
-    });
-    throw new ManifestError("Failed to parse game manifest", "permanent", {
-      ...base,
-      fetchOutcome: "invalid_body",
-      status: response.status,
-      contentType: response.headers.get("content-type") ?? undefined,
-      cfRay: response.headers.get("cf-ray") ?? undefined,
-      redirected: response.redirected
-    });
-  }
-}
-// src/core/transport/request.ts
-function prepareRequestBody(body, headers) {
-  if (body instanceof FormData) {
-    return body;
-  }
-  if (body instanceof ArrayBuffer || body instanceof Blob || ArrayBuffer.isView(body)) {
-    if (!headers["Content-Type"]) {
-      headers["Content-Type"] = "application/octet-stream";
-    }
-    return body;
-  }
-  if (body !== undefined && body !== null) {
-    if (headers["Content-Type"]) {
-      return typeof body === "string" ? body : JSON.stringify(body);
-    }
-    headers["Content-Type"] = "application/json";
-    return JSON.stringify(body);
-  }
-  return;
-}
-function checkDevWarnings(data) {
-  if (!data || typeof data !== "object") {
-    return;
-  }
-  const response = data;
-  const warningType = response.__playcademyDevWarning;
-  if (!warningType) {
-    return;
-  }
-  switch (warningType) {
-    case "timeback-not-configured": {
-      console.warn("%c⚠️ TimeBack Not Configured", "background: #f59e0b; color: white; padding: 6px 12px; border-radius: 4px; font-weight: bold; font-size: 13px");
-      console.log("%cTimeBack is configured in playcademy.config.js but the sandbox does not have TimeBack credentials.", "color: #f59e0b; font-weight: 500");
-      console.log("To test TimeBack locally:");
-      console.log("  Set the following environment variables:");
-      console.log("    • %cTIMEBACK_ONEROSTER_API_URL", "color: #0ea5e9; font-weight: 600; font-family: monospace");
-      console.log("    • %cTIMEBACK_CALIPER_API_URL", "color: #0ea5e9; font-weight: 600; font-family: monospace");
-      console.log("    • %cTIMEBACK_API_CLIENT_ID/SECRET", "color: #0ea5e9; font-weight: 600; font-family: monospace");
-      console.log("  Or deploy your game: %cplaycademy deploy", "color: #10b981; font-weight: 600; font-family: monospace");
-      console.log("  Or wait for %c@superbuilders/timeback-local%c (coming soon)", "color: #8b5cf6; font-weight: 600; font-family: monospace", "color: inherit");
-      break;
-    }
-    default: {
-      console.warn(`[Playcademy Dev Warning] ${warningType}`);
-    }
-  }
-}
-async function request({
-  path,
-  baseUrl,
-  method = "GET",
-  body,
-  extraHeaders = {},
-  raw = false
-}) {
-  const url = baseUrl.replace(/\/$/, "") + (path.startsWith("/") ? path : `/${path}`);
-  const headers = { ...extraHeaders };
-  const payload = prepareRequestBody(body, headers);
-  const res = unwrapFetchResult(await fetchWithRetry(url, {
-    method,
-    headers,
-    body: payload,
-    credentials: "omit"
-  }));
-  if (raw) {
-    return res;
-  }
-  if (!res.ok) {
-    const clonedRes = res.clone();
-    const errorBody = await clonedRes.json().catch(() => clonedRes.text().catch(() => {
-      return;
-    })) ?? undefined;
-    throw ApiError.fromResponse(res.status, res.statusText, errorBody);
-  }
-  if (res.status === 204) {
-    return;
-  }
-  const contentType = res.headers.get("content-type") ?? "";
-  if (contentType.includes("application/json")) {
-    try {
-      const parsed = await res.json();
-      checkDevWarnings(parsed);
-      return parsed;
-    } catch (error) {
-      if (error instanceof SyntaxError) {
-        return;
-      }
-      throw error;
-    }
-  }
-  const rawText = await res.text().catch(() => "");
-  return rawText && rawText.length > 0 ? rawText : undefined;
-}
 // src/namespaces/platform/games.ts
 function createGamesNamespace(client) {
   const gamesListCache = createTTLCache({
@@ -2284,7 +2043,7 @@ function createGamesNamespace(client) {
       return gameFetchCache.get(gameIdOrSlug, async () => {
         const baseGameData = await promise;
         if (baseGameData.gameType === "hosted" && baseGameData.deploymentUrl !== null && baseGameData.deploymentUrl !== undefined && baseGameData.deploymentUrl !== "") {
-          const manifestData = await fetchManifest(baseGameData.deploymentUrl);
+          const manifestData = await client["request"](`/games/${baseGameData.id}/manifest`, "GET");
           return { ...baseGameData, manifest: manifestData };
         }
         return baseGameData;
@@ -2709,8 +2468,8 @@ function createTimebackNamespace2(client) {
       throw new Error(NOT_SUPPORTED);
     },
     management: {
-      setup: (request2) => client["request"]("/timeback/setup", "POST", {
-        body: request2
+      setup: (request) => client["request"]("/timeback/setup", "POST", {
+        body: request
       }),
       verify: (gameId) => client["request"](`/timeback/verify/${gameId}`, "GET"),
       cleanup: (gameId) => client["request"](`/timeback/integrations/${gameId}`, "DELETE"),
@@ -2786,17 +2545,17 @@ function createTimebackNamespace2(client) {
         }
         return client["request"](`/timeback/student-activity/${timebackId}/${courseId}?${params}`, "GET");
       },
-      grantXp: (request2) => client["request"]("/timeback/grant-xp", "POST", {
-        body: request2
+      grantXp: (request) => client["request"]("/timeback/grant-xp", "POST", {
+        body: request
       }),
-      adjustTime: (request2) => client["request"]("/timeback/adjust-time", "POST", {
-        body: request2
+      adjustTime: (request) => client["request"]("/timeback/adjust-time", "POST", {
+        body: request
       }),
-      adjustMastery: (request2) => client["request"]("/timeback/adjust-mastery", "POST", {
-        body: request2
+      adjustMastery: (request) => client["request"]("/timeback/adjust-mastery", "POST", {
+        body: request
       }),
-      toggleCompletion: (request2) => client["request"]("/timeback/toggle-completion", "POST", {
-        body: request2
+      toggleCompletion: (request) => client["request"]("/timeback/toggle-completion", "POST", {
+        body: request
       })
     }
   };
@@ -3105,6 +2864,143 @@ class ConnectionManager {
     }
   }
 }
+// src/core/transport/retry.ts
+var RETRY_DELAYS_MS = [500, 1500];
+function wait(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+var retryRuntime = { wait };
+function isRetryableStatus(status) {
+  return status === 429 || status >= 500;
+}
+async function fetchWithRetry(url, init2) {
+  const startedAt = Date.now();
+  for (let attempt = 0;attempt <= RETRY_DELAYS_MS.length; attempt++) {
+    const retryDelayMs = RETRY_DELAYS_MS[attempt];
+    const canRetry = init2.method === "GET" && retryDelayMs !== undefined;
+    try {
+      const response = await fetch(url, init2);
+      if (canRetry && isRetryableStatus(response.status)) {
+        await retryRuntime.wait(retryDelayMs);
+      } else {
+        return { response, retryCount: attempt, durationMs: Date.now() - startedAt };
+      }
+    } catch (error) {
+      if (canRetry && error instanceof TypeError) {
+        await retryRuntime.wait(retryDelayMs);
+      } else {
+        return { error, retryCount: attempt, durationMs: Date.now() - startedAt };
+      }
+    }
+  }
+  return {
+    error: new PlaycademyError("Request failed after exhausting retries"),
+    retryCount: RETRY_DELAYS_MS.length,
+    durationMs: Date.now() - startedAt
+  };
+}
+function unwrapFetchResult(result) {
+  if (result.error) {
+    throw result.error;
+  }
+  if (!result.response) {
+    throw new PlaycademyError("Request failed after exhausting retries");
+  }
+  return result.response;
+}
+// src/core/transport/request.ts
+function prepareRequestBody(body, headers) {
+  if (body instanceof FormData) {
+    return body;
+  }
+  if (body instanceof ArrayBuffer || body instanceof Blob || ArrayBuffer.isView(body)) {
+    if (!headers["Content-Type"]) {
+      headers["Content-Type"] = "application/octet-stream";
+    }
+    return body;
+  }
+  if (body !== undefined && body !== null) {
+    if (headers["Content-Type"]) {
+      return typeof body === "string" ? body : JSON.stringify(body);
+    }
+    headers["Content-Type"] = "application/json";
+    return JSON.stringify(body);
+  }
+  return;
+}
+function checkDevWarnings(data) {
+  if (!data || typeof data !== "object") {
+    return;
+  }
+  const response = data;
+  const warningType = response.__playcademyDevWarning;
+  if (!warningType) {
+    return;
+  }
+  switch (warningType) {
+    case "timeback-not-configured": {
+      console.warn("%c⚠️ TimeBack Not Configured", "background: #f59e0b; color: white; padding: 6px 12px; border-radius: 4px; font-weight: bold; font-size: 13px");
+      console.log("%cTimeBack is configured in playcademy.config.js but the sandbox does not have TimeBack credentials.", "color: #f59e0b; font-weight: 500");
+      console.log("To test TimeBack locally:");
+      console.log("  Set the following environment variables:");
+      console.log("    • %cTIMEBACK_ONEROSTER_API_URL", "color: #0ea5e9; font-weight: 600; font-family: monospace");
+      console.log("    • %cTIMEBACK_CALIPER_API_URL", "color: #0ea5e9; font-weight: 600; font-family: monospace");
+      console.log("    • %cTIMEBACK_API_CLIENT_ID/SECRET", "color: #0ea5e9; font-weight: 600; font-family: monospace");
+      console.log("  Or deploy your game: %cplaycademy deploy", "color: #10b981; font-weight: 600; font-family: monospace");
+      console.log("  Or wait for %c@superbuilders/timeback-local%c (coming soon)", "color: #8b5cf6; font-weight: 600; font-family: monospace", "color: inherit");
+      break;
+    }
+    default: {
+      console.warn(`[Playcademy Dev Warning] ${warningType}`);
+    }
+  }
+}
+async function request({
+  path,
+  baseUrl,
+  method = "GET",
+  body,
+  extraHeaders = {},
+  raw = false
+}) {
+  const url = baseUrl.replace(/\/$/, "") + (path.startsWith("/") ? path : `/${path}`);
+  const headers = { ...extraHeaders };
+  const payload = prepareRequestBody(body, headers);
+  const res = unwrapFetchResult(await fetchWithRetry(url, {
+    method,
+    headers,
+    body: payload,
+    credentials: "omit"
+  }));
+  if (raw) {
+    return res;
+  }
+  if (!res.ok) {
+    const clonedRes = res.clone();
+    const errorBody = await clonedRes.json().catch(() => clonedRes.text().catch(() => {
+      return;
+    })) ?? undefined;
+    throw ApiError.fromResponse(res.status, res.statusText, errorBody);
+  }
+  if (res.status === 204) {
+    return;
+  }
+  const contentType = res.headers.get("content-type") ?? "";
+  if (contentType.includes("application/json")) {
+    try {
+      const parsed = await res.json();
+      checkDevWarnings(parsed);
+      return parsed;
+    } catch (error) {
+      if (error instanceof SyntaxError) {
+        return;
+      }
+      throw error;
+    }
+  }
+  const rawText = await res.text().catch(() => "");
+  return rawText && rawText.length > 0 ? rawText : undefined;
+}
 // src/clients/base.ts
 class PlaycademyBaseClient {
   baseUrl;
@@ -3321,14 +3217,12 @@ class PlaycademyInternalClient extends PlaycademyBaseClient {
   static identity = identity;
 }
 export {
-  probeCorsReachability,
   messaging,
   extractApiErrorInfo,
   PlaycademyInternalClient,
   PlaycademyError,
   PlaycademyInternalClient as PlaycademyClient,
   MessageEvents,
-  ManifestError,
   ConnectionMonitor,
   ConnectionManager,
   ApiError

package/dist/server.js

@@ -82,18 +82,6 @@ class PlaycademyError extends Error {
   }
 }
 
-class ManifestError extends PlaycademyError {
-  kind;
-  details;
-  constructor(message, kind, details) {
-    super(message);
-    this.name = "ManifestError";
-    this.kind = kind;
-    this.details = details;
-    Object.setPrototypeOf(this, ManifestError.prototype);
-  }
-}
-
 class ApiError extends Error {
   code;
   details;

package/dist/types.d.ts

@@ -22,36 +22,6 @@ declare function parseOAuthState(state: string): {
 /** Permitted HTTP verbs */
 type Method = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 
-/**
- * Game Types
- *
- * Literal types and API DTOs. Database row types are in @playcademy/data/types.
- *
- * @module types/game
- */
-type GameType = 'hosted' | 'external';
-type GamePlatform = 'web' | 'godot' | 'unity' | (string & {});
-/**
- * Game manifest file format (manifest.json).
- * Note: createdAt is a string here because it's parsed from JSON file.
- */
-interface ManifestV1 {
-    version: string;
-    platform: string;
-    createdAt: string;
-}
-interface DomainValidationRecords {
-    ownership?: {
-        name?: string;
-        value?: string;
-        type?: string;
-    };
-    ssl?: {
-        txt_name?: string;
-        txt_value?: string;
-    }[];
-}
-
 /**
  * User Types
  *
@@ -132,6 +102,36 @@ interface GameUser {
     timeback?: UserTimebackData;
 }
 
+/**
+ * Game Types
+ *
+ * Literal types and API DTOs. Database row types are in @playcademy/data/types.
+ *
+ * @module types/game
+ */
+type GameType = 'hosted' | 'external';
+type GamePlatform = 'web' | 'godot' | 'unity' | (string & {});
+/**
+ * Game manifest file format (manifest.json).
+ * Note: createdAt is a string here because it's parsed from JSON file.
+ */
+interface ManifestV1 {
+    version: string;
+    platform: string;
+    createdAt: string;
+}
+interface DomainValidationRecords {
+    ownership?: {
+        name?: string;
+        value?: string;
+        type?: string;
+    };
+    ssl?: {
+        txt_name?: string;
+        txt_value?: string;
+    }[];
+}
+
 /**
  * Leaderboard Types
  *

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.3.6-beta.2",
+    "version": "0.3.6-beta.4",
     "type": "module",
     "exports": {
         ".": {