@playcademy/sdk 0.13.1-beta.4 → 0.14.1-beta.1

package/dist/internal.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;
     }
   };
 }
@@ -3082,7 +3089,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.13.1-beta.4";
+var SDK_VERSION = "0.14.1-beta.1";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {
@@ -3097,6 +3104,7 @@ class PlaycademyBaseClient {
   initPayload;
   launchId;
   gameOrigin;
+  browserTimeZone;
   constructor(config) {
     this.baseUrl = config?.baseUrl?.endsWith("/api") ? config.baseUrl : `${config?.baseUrl}/api`;
     this.gameUrl = config?.gameUrl;
@@ -3125,6 +3133,9 @@ class PlaycademyBaseClient {
   ping() {
     return "pong";
   }
+  get localDay() {
+    return this.initPayload?.localDay;
+  }
   setToken(token, tokenType) {
     this.authStrategy = createAuthStrategy(token, tokenType);
     this.emit("authChange", { token });
@@ -3168,11 +3179,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({
@@ -3185,6 +3198,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,

package/dist/server/edge.js

@@ -233,7 +233,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.13.1-beta.4";
+var SDK_VERSION = "0.14.1-beta.1";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/server.js

@@ -422,7 +422,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.13.1-beta.4";
+var SDK_VERSION = "0.14.1-beta.1";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 import * as _playcademy_types from '@playcademy/types';
-import { GameManifest } from '@playcademy/types';
-export { AuthenticatedUser, DeveloperStatusEnumType, DeveloperStatusResponse, DeveloperStatusValue, GameCourseMetrics, GameLeaderboardEntry, GameManifest, GameMetricComparisonKind, GameMetricComparisonMetric, GameMetricComparisonRow, GameMetricComparisonRowStatus, GameMetricsProxyResponse, GameMetricsResponse, GameMetricsUnsupportedReason, GamePlatform, GameRunMetrics, GameRunMetricsComparison, GameRunMetricsComparisonStatus, GameRunMetricsComparisonSummary, GameTimebackIntegration, GameType, GameUser, LeaderboardEntry, LeaderboardOptions, LeaderboardTimeframe, ManifestV1, ManifestV2, ManifestVersions, PopulateStudentResponse, UserEnrollment, UserInfo, UserOrganization, UserRank, UserRankResponse, UserRoleEnumType, UserScore, UserTimebackData } from '@playcademy/types';
+import { GameManifest, LocalDayContext } from '@playcademy/types';
+export { AuthenticatedUser, DeveloperStatusEnumType, DeveloperStatusResponse, DeveloperStatusValue, GameCourseMetrics, GameLeaderboardEntry, GameManifest, GameMetricComparisonKind, GameMetricComparisonMetric, GameMetricComparisonRow, GameMetricComparisonRowStatus, GameMetricsProxyResponse, GameMetricsResponse, GameMetricsUnsupportedReason, GamePlatform, GameRunMetrics, GameRunMetricsComparison, GameRunMetricsComparisonStatus, GameRunMetricsComparisonSummary, GameTimebackIntegration, GameType, GameUser, LeaderboardEntry, LeaderboardOptions, LeaderboardTimeframe, LocalDayContext, LocalDaySource, ManifestV1, ManifestV2, ManifestVersions, PopulateStudentResponse, UserEnrollment, UserInfo, UserOrganization, UserRank, UserRankResponse, UserRoleEnumType, UserScore, UserTimebackData } from '@playcademy/types';
 import { TimebackCourseConfig, CourseConfig, OrganizationConfig, ComponentConfig, ResourceConfig, ComponentResourceConfig, TimebackGrade, TimebackSubject, HeartbeatRequest } from '@playcademy/types/timeback';
 export { QtiTestQuestionRef, QtiTestQuestionsResponse } from '@playcademy/types/timeback';
 import { TimebackUserRole, UserEnrollment, UserOrganization, UserInfo } from '@playcademy/types/user';
@@ -506,6 +506,40 @@ declare const users: drizzle_orm_pg_core.PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        learningTimeZone: drizzle_orm_pg_core.PgColumn<{
+            name: "learning_time_zone";
+            tableName: "user";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        learningTimeZoneUpdatedAt: drizzle_orm_pg_core.PgColumn<{
+            name: "learning_time_zone_updated_at";
+            tableName: "user";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         emailVerified: drizzle_orm_pg_core.PgColumn<{
             name: "email_verified";
             tableName: "user";
@@ -1166,6 +1200,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.
@@ -1179,6 +1214,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.
      */
@@ -1235,6 +1274,7 @@ declare abstract class PlaycademyBaseClient {
         raw?: boolean;
         retryPolicy?: RetryPolicy;
     }): Promise<T>;
+    private getBrowserTimeZone;
     /**
      * Makes an authenticated HTTP request to the game's backend Worker.
      */
@@ -1817,6 +1857,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/package.json

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