@playcademy/sdk 0.0.5 → 0.0.7

package/dist/server.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Basic user information in the shape of the claims from identity providers
+ */
+interface UserInfo {
+    /** Unique user identifier (sub claim from JWT) */
+    sub: string;
+    /** User's email address */
+    email: string;
+    /** User's display name */
+    name: string;
+    /** Whether the email has been verified */
+    email_verified: boolean;
+    /** Optional given name (first name) */
+    given_name?: string;
+    /** Optional family name (last name) */
+    family_name?: string;
+    /** Additional user attributes from the identity provider */
+    [key: string]: unknown;
+}
+
+/**
+ * Server-only utilities for Playcademy.
+ *
+ * NOTE: This module is intended for backend/server runtimes. It should not be
+ * bundled into browser code. The API intentionally avoids requiring a
+ * PlaycademyClient instance, offering stateless helpers for auth flows.
+ */
+
+/**
+ * Verifies a short-lived Playcademy Game Token and returns verified identity claims.
+ *
+ * This calls the Playcademy API to cryptographically verify the token and
+ * returns the verified user information and claims.
+ *
+ * @param gameToken - The game JWT token to verify
+ * @param options - Optional configuration (reserved for future use)
+ * @returns Promise containing verified claims, gameId, and user information
+ * @throws Error if token is invalid or verification fails
+ */
+declare function verifyGameToken(gameToken: string, options?: {
+    baseUrl?: string;
+}): Promise<{
+    claims: Record<string, unknown>;
+    gameId: string;
+    user: UserInfo;
+}>;
+declare const PlaycademyServer: {
+    auth: {
+        verifyGameToken: typeof verifyGameToken;
+    };
+};
+
+export { PlaycademyServer, verifyGameToken };

package/dist/server.js

@@ -0,0 +1,50 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// src/server.ts
+async function verifyGameToken(gameToken, options) {
+  if (!gameToken || typeof gameToken !== "string") {
+    throw new Error("[Playcademy SDK] gameToken must be a non-empty string");
+  }
+  const baseUrl = options?.baseUrl || process.env.PLAYCADEMY_BASE_URL || process.env.PUBLIC_PLAYCADEMY_BASE_URL || process.env.NEXT_PUBLIC_PLAYCADEMY_BASE_URL;
+  if (!baseUrl) {
+    throw new Error(`[Playcademy SDK] PLAYCADEMY_BASE_URL is not set
+Please set the PLAYCADEMY_BASE_URL environment variable`);
+  }
+  try {
+    const response = await fetch(`${baseUrl}/api/games/verify`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ token: gameToken })
+    });
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => "Unknown error");
+      throw new Error(`[Playcademy SDK] Token verification failed: ${response.status} ${errorText}`);
+    }
+    const result = await response.json();
+    return result;
+  } catch (error) {
+    if (error instanceof Error) {
+      throw error;
+    }
+    throw new Error("[Playcademy SDK] Token verification failed: Network error");
+  }
+}
+var PlaycademyServer = {
+  auth: { verifyGameToken }
+};
+export {
+  verifyGameToken,
+  PlaycademyServer
+};