@playcademy/sdk 0.14.0 → 0.14.1-beta.1

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import * as _playcademy_types from '@playcademy/types';
+import { LocalDayContext } from '@playcademy/types';
 import { TimebackGrade, TimebackSubject, HeartbeatRequest } from '@playcademy/types/timeback';
 import { TimebackUserRole, UserEnrollment, UserOrganization, UserInfo } from '@playcademy/types/user';
 import { AUTH_PROVIDER_IDS } from '@playcademy/constants';
@@ -227,6 +228,7 @@ declare abstract class PlaycademyBaseClient {
     protected initPayload?: InitPayload;
     protected launchId?: string;
     protected gameOrigin?: string;
+    private browserTimeZone?;
     constructor(config?: Partial<ClientConfig>);
     /**
      * Gets the effective base URL for API requests.
@@ -240,6 +242,10 @@ declare abstract class PlaycademyBaseClient {
      * Simple ping method for testing connectivity.
      */
     ping(): string;
+    /**
+     * Local day context supplied by the platform during iframe initialization.
+     */
+    get localDay(): LocalDayContext | undefined;
     /**
      * Sets the authentication token for API requests.
      */
@@ -296,6 +302,7 @@ declare abstract class PlaycademyBaseClient {
         raw?: boolean;
         retryPolicy?: RetryPolicy;
     }): Promise<T>;
+    private getBrowserTimeZone;
     /**
      * Makes an authenticated HTTP request to the game's backend Worker.
      */
@@ -1451,6 +1458,8 @@ interface InitPayload {
     gameId: string;
     /** Timeback context (if user has a Timeback account) */
     timeback?: TimebackInitContext;
+    /** Playcademy context for resolving the student's local learning day */
+    localDay?: LocalDayContext;
     /** Runtime mode for the game client */
     mode?: PlaycademyMode;
     /** Launch session correlation ID (UUID, set by platform on game launch) */

package/dist/index.js

@@ -1137,6 +1137,8 @@ function isValidGrade(value) {
 function isValidSubject(value) {
   return typeof value === "string" && VALID_SUBJECTS.includes(value);
 }
+// ../constants/src/platform.ts
+var PLAYCADEMY_BROWSER_TIME_ZONE_HEADER = "x-playcademy-browser-time-zone";
 // ../constants/src/timeback.ts
 var TIMEBACK_ROUTES = {
   END_ACTIVITY: "/integrations/timeback/end-activity",
@@ -2122,7 +2124,12 @@ function createUsersNamespace(client) {
   return {
     me: async () => {
       assertPlatformMode(client, "users.me()");
-      return client["request"]("/users/me", "GET");
+      const user = await client["request"]("/users/me", "GET");
+      const initPayload = client["initPayload"];
+      if (initPayload) {
+        initPayload.localDay = user.localDay;
+      }
+      return user;
     }
   };
 }
@@ -2379,7 +2386,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.14.0";
+var SDK_VERSION = "0.14.1-beta.1";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {
@@ -2394,6 +2401,7 @@ class PlaycademyBaseClient {
   initPayload;
   launchId;
   gameOrigin;
+  browserTimeZone;
   constructor(config) {
     this.baseUrl = config?.baseUrl?.endsWith("/api") ? config.baseUrl : `${config?.baseUrl}/api`;
     this.gameUrl = config?.gameUrl;
@@ -2422,6 +2430,9 @@ class PlaycademyBaseClient {
   ping() {
     return "pong";
   }
+  get localDay() {
+    return this.initPayload?.localDay;
+  }
   setToken(token, tokenType) {
     this.authStrategy = createAuthStrategy(token, tokenType);
     this.emit("authChange", { token });
@@ -2465,11 +2476,13 @@ class PlaycademyBaseClient {
     });
   }
   async request(path, method, options) {
+    const browserTimeZone = this.getBrowserTimeZone();
     const effectiveHeaders = {
       ...options?.headers,
       ...this.authStrategy.getHeaders(),
       ...this.launchId ? { "x-playcademy-launch-id": this.launchId } : {},
       ...this.gameOrigin ? { "x-playcademy-game-origin": this.gameOrigin } : {},
+      ...browserTimeZone ? { [PLAYCADEMY_BROWSER_TIME_ZONE_HEADER]: browserTimeZone } : {},
       "x-playcademy-sdk-version": SDK_VERSION
     };
     return request({
@@ -2482,6 +2495,22 @@ class PlaycademyBaseClient {
       retryPolicy: options?.retryPolicy
     });
   }
+  getBrowserTimeZone() {
+    if (this.browserTimeZone !== undefined) {
+      return this.browserTimeZone ?? undefined;
+    }
+    if (typeof globalThis.window === "undefined") {
+      this.browserTimeZone = null;
+      return;
+    }
+    try {
+      const timeZone = new Intl.DateTimeFormat().resolvedOptions().timeZone;
+      this.browserTimeZone = typeof timeZone === "string" && timeZone ? timeZone : null;
+    } catch {
+      this.browserTimeZone = null;
+    }
+    return this.browserTimeZone ?? undefined;
+  }
   async requestGameBackend(path, method, body, headers, options) {
     const effectiveHeaders = {
       ...headers,