@djangocfg/api 2.1.591 → 2.1.592

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/api",
-  "version": "2.1.591",
+  "version": "2.1.592",
   "description": "Auto-generated TypeScript API client with React hooks, SWR integration, and Zod validation for Django REST Framework backends",
   "keywords": [
     "django",
@@ -91,7 +91,7 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@djangocfg/typescript-config": "^2.1.591",
+    "@djangocfg/typescript-config": "^2.1.592",
     "@testing-library/react": "^16.3.2",
     "@types/node": "^25.9.5",
     "@types/react": "19.2.15",

package/src/_api/generated/helpers/auth.ts

@@ -123,6 +123,15 @@ function defaultBaseUrl(): string {
   return '';
 }
 
+/** The browser's IANA zone; null where Intl cannot tell (e.g. a bare server runtime). */
+function detectTimezone(): string | null {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone || null;
+  } catch {
+    return null;
+  }
+}
+
 /** Default API key fallback from `NEXT_PUBLIC_API_KEY`.
  *
  * Both browser and server: if NEXT_PUBLIC_API_KEY is set it is used as a
@@ -140,6 +149,7 @@ function defaultApiKey(): string | null {
 
 // ── In-memory overrides (win over storage / env) ───────────────────────────
 let _localeOverride: string | null = null;
+let _timezoneOverride: string | null = null;
 let _apiKeyOverride: string | null = null;
 let _baseUrlOverride: string | null = null;
 let _withCredentials = true;
@@ -450,6 +460,11 @@ export const auth = {
   getLocale(): string | null { return _localeOverride ?? detectLocale(); },
   setLocale(locale: string | null): void { _localeOverride = locale; },
 
+  // ── Time zone ─────────────────────────────────────────────────────
+  // IANA name sent as `X-Timezone`. `null` override = follow the browser.
+  getTimezone(): string | null { return _timezoneOverride ?? detectTimezone(); },
+  setTimezone(timezone: string | null): void { _timezoneOverride = timezone; },
+
   // ── Base URL ──────────────────────────────────────────────────────
   getBaseUrl(): string {
     const url = (_baseUrlOverride ?? defaultBaseUrl());
@@ -759,10 +774,8 @@ export function installAuthOnClient(client: HeyClient): void {
     const apiKey = auth.getApiKey();
     if (apiKey && !request.headers.has('X-API-Key')) request.headers.set('X-API-Key', apiKey);
 
-    try {
-      const tz = Intl.DateTimeFormat().resolvedOptions().timeZone;
-      if (tz) request.headers.set('X-Timezone', tz);
-    } catch {}
+    const tz = auth.getTimezone();
+    if (tz) request.headers.set('X-Timezone', tz);
     request.headers.set('X-Client-Time', new Date().toISOString());
 
     // DPoP proof — sign a fresh per-request proof with the non-extractable key.

package/src/auth/__tests__/timezone.test.ts

@@ -0,0 +1,18 @@
+import { beforeEach, describe, expect, it } from 'vitest';
+
+import { auth } from '../../_api/generated/helpers/auth';
+
+describe('auth time zone override', () => {
+  beforeEach(() => auth.setTimezone(null));
+
+  it('follows the browser until overridden', () => {
+    expect(auth.getTimezone()).toBe(Intl.DateTimeFormat().resolvedOptions().timeZone);
+  });
+
+  it('returns the override and clears back to the browser zone', () => {
+    auth.setTimezone('Asia/Seoul');
+    expect(auth.getTimezone()).toBe('Asia/Seoul');
+    auth.setTimezone(null);
+    expect(auth.getTimezone()).toBe(Intl.DateTimeFormat().resolvedOptions().timeZone);
+  });
+});

package/src/auth/hooks/index.ts

@@ -3,6 +3,9 @@
 // Session (reactive snapshot from the generated auth store)
 export { useSession, type SessionSnapshot, type SessionStatus } from './useSession';
 
+// Time zone preference (X-Timezone override)
+export { useTimezone, type UseTimezoneReturn } from './useTimezone';
+
 // Router hooks
 export { useCfgRouter } from './useCfgRouter';
 export { useQueryParams } from './useQueryParams';

package/src/auth/hooks/useTimezone.ts

@@ -0,0 +1,67 @@
+'use client';
+
+import { useCallback, useSyncExternalStore } from 'react';
+
+import { auth } from '../../_api/generated/helpers/auth';
+
+/**
+ * Time zone preference. The choice lives on the device (localStorage) and is
+ * pushed into the generated auth store, which sends it as `X-Timezone` on every
+ * request; Django's TimezoneMiddleware then activates it and mirrors it onto
+ * the profile. `null` = automatic (follow the browser).
+ */
+const STORAGE_KEY = 'djangocfg.timezone';
+
+const listeners = new Set<() => void>();
+
+function read(): string | null {
+  try {
+    return localStorage.getItem(STORAGE_KEY) || null;
+  } catch {
+    return null;
+  }
+}
+
+/** Apply the stored choice to the transport before any request goes out. */
+function hydrate(): void {
+  if (typeof window === 'undefined') return;
+  auth.setTimezone(read());
+}
+hydrate();
+
+function write(timezone: string | null): void {
+  try {
+    if (timezone) localStorage.setItem(STORAGE_KEY, timezone);
+    else localStorage.removeItem(STORAGE_KEY);
+  } catch {
+    /* storage unavailable — the choice then lasts for this page only */
+  }
+  auth.setTimezone(timezone);
+  listeners.forEach((l) => l());
+}
+
+function subscribe(listener: () => void): () => void {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+
+export interface UseTimezoneReturn {
+  /** Zone in effect: the explicit choice, else the browser's. `null` only where Intl cannot tell. */
+  timezone: string | null;
+  /** The explicit choice; `null` = automatic. Feed this to `TimezoneSelect`. */
+  preference: string | null;
+  isAuto: boolean;
+  /** Pick a zone, or `null` for automatic. */
+  setTimezone: (timezone: string | null) => void;
+}
+
+export function useTimezone(): UseTimezoneReturn {
+  const preference = useSyncExternalStore(subscribe, read, () => null);
+  const setTimezone = useCallback((tz: string | null) => write(tz), []);
+  return {
+    timezone: preference ?? auth.getTimezone(),
+    preference,
+    isAuto: preference === null,
+    setTimezone,
+  };
+}