@djangocfg/api 2.1.331 → 2.1.333

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/api",
-  "version": "2.1.331",
+  "version": "2.1.333",
   "description": "Auto-generated TypeScript API client with React hooks, SWR integration, and Zod validation for Django REST Framework backends",
   "keywords": [
     "django",
@@ -79,7 +79,7 @@
   "devDependencies": {
     "@types/node": "^24.7.2",
     "@types/react": "^19.1.0",
-    "@djangocfg/typescript-config": "^2.1.331",
+    "@djangocfg/typescript-config": "^2.1.333",
     "next": "^16.2.2",
     "react": "^19.1.0",
     "tsup": "^8.5.0",

package/src/_api/generated/_cfg_accounts/api.ts

@@ -1,36 +1,16 @@
 // AUTO-GENERATED by django_generator / ts_extras.wrapper
-// Self-contained API wrapper for this group. DO NOT EDIT — re-run `make gen`.
+// Thin per-group proxy over the global `auth` store. All actual auth
+// wiring lives in `helpers/auth.ts` (one interceptor, one source of
+// truth). DO NOT EDIT — re-run `make gen`.
 
-import { client } from '../client.gen';
-import type { StorageAdapter } from '../helpers/storage';
-import { LocalStorageAdapter } from '../helpers/storage';
+import { auth } from '../helpers/auth';
 import { APILogger, type LoggerConfig } from '../helpers/logger';
 
 
 
 
-const ACCESS_KEY = 'cfg.access_token';
-const REFRESH_KEY = 'cfg.refresh_token';
-
-
-
-/** Auto-detect locale from cookie NEXT_LOCALE or navigator.language. */
-function detectLocale(): string | null {
-  try {
-    if (typeof document !== 'undefined') {
-      const m = document.cookie.match(/(?:^|;\s*)NEXT_LOCALE=([^;]*)/);
-      if (m) return decodeURIComponent(m[1]);
-    }
-    if (typeof navigator !== 'undefined' && navigator.language) {
-      return navigator.language;
-    }
-  } catch {}
-  return null;
-}
 
 export interface APIOptions {
-  /** Override storage backend (LocalStorage by default; Memory for SSR/tests). */
-  storage?: StorageAdapter;
   /** Logger config (defaults to dev-only). */
   logger?: Partial<LoggerConfig>;
   /** Locale for `Accept-Language`. If omitted, auto-detected from cookie/navigator. */
@@ -42,79 +22,46 @@ export interface APIOptions {
 }
 
 /**
- * Self-contained API wrapper for this group.
+ * Per-group ergonomic facade.
  *
- * Each group has its own client + interceptor + token store. The interceptor
- * automatically attaches:
- *   - `Authorization: Bearer <jwt>` from storage
- *   - `Accept-Language` from `opts.locale` or `NEXT_LOCALE` cookie
- *   - `X-API-Key` from `opts.apiKey` or `NEXT_PUBLIC_API_KEY`
- *   - `credentials: 'include'` for Django session/CSRF cookies (toggle via opts)
+ * Calling `setToken/setApiKey/setLocale/setBaseUrl` proxies to the
+ * global `auth` store — the change applies to **every** group's API
+ * instance because they share the same HTTP client and interceptor.
+ *
+ * Use the global `auth` object directly when you don't need a group
+ * facade: `import { auth } from '@your/api'; auth.setToken(jwt);`
  */
 export class API {
-  private baseUrl: string;
-  private storage: StorageAdapter;
-  private locale: string | null;
-  private apiKey: string | null;
   readonly logger: APILogger;
 
 
 
-  constructor(baseUrl: string, opts: APIOptions = {}) {
-    this.baseUrl = baseUrl.replace(/\/$/, '');
-    this.storage = opts.storage ?? new LocalStorageAdapter();
+  constructor(_baseUrl?: string, opts: APIOptions = {}) {
     this.logger = new APILogger(opts.logger);
-    this.locale = opts.locale ?? null;
-    this.apiKey = opts.apiKey ?? (typeof process !== 'undefined' ? (process.env?.NEXT_PUBLIC_API_KEY ?? null) : null);
-
-    const credentials: RequestCredentials = (opts.withCredentials ?? true) ? 'include' : 'same-origin';
-    client.setConfig({ baseUrl: this.baseUrl, credentials });
-
-    client.interceptors.request.use((request) => {
-      const access = this.getToken();
-      if (access) request.headers.set('Authorization', `Bearer ${access}`);
-
-      const locale = this.locale ?? detectLocale();
-      if (locale) request.headers.set('Accept-Language', locale);
-
-      if (this.apiKey) request.headers.set('X-API-Key', this.apiKey);
-
-      return request;
-    });
-
-
+    if (_baseUrl) auth.setBaseUrl(_baseUrl);
+    if (opts.locale !== undefined) auth.setLocale(opts.locale);
+    if (opts.apiKey !== undefined) auth.setApiKey(opts.apiKey);
+    if (opts.withCredentials !== undefined) auth.setWithCredentials(opts.withCredentials);
   }
 
   // ── Base URL ────────────────────────────────────────────────────────────
-  getBaseUrl(): string { return this.baseUrl; }
-  setBaseUrl(url: string): void {
-    this.baseUrl = url.replace(/\/$/, '');
-    client.setConfig({ baseUrl: this.baseUrl });
-  }
+  getBaseUrl(): string { return auth.getBaseUrl(); }
+  setBaseUrl(url: string): void { auth.setBaseUrl(url); }
 
   // ── Tokens ──────────────────────────────────────────────────────────────
-  getToken(): string | null { return this.storage.getItem(ACCESS_KEY); }
-  setToken(token: string | null): void {
-    if (token) this.storage.setItem(ACCESS_KEY, token);
-    else this.storage.removeItem(ACCESS_KEY);
-  }
-  getRefreshToken(): string | null { return this.storage.getItem(REFRESH_KEY); }
-  setRefreshToken(token: string | null): void {
-    if (token) this.storage.setItem(REFRESH_KEY, token);
-    else this.storage.removeItem(REFRESH_KEY);
-  }
-  clearToken(): void {
-    this.storage.removeItem(ACCESS_KEY);
-    this.storage.removeItem(REFRESH_KEY);
-  }
-  isAuthenticated(): boolean { return this.getToken() !== null; }
+  getToken(): string | null { return auth.getToken(); }
+  setToken(token: string | null): void { auth.setToken(token); }
+  getRefreshToken(): string | null { return auth.getRefreshToken(); }
+  setRefreshToken(token: string | null): void { auth.setRefreshToken(token); }
+  clearToken(): void { auth.clearTokens(); }
+  isAuthenticated(): boolean { return auth.isAuthenticated(); }
 
   // ── Locale / API key ────────────────────────────────────────────────────
-  getLocale(): string | null { return this.locale ?? detectLocale(); }
-  setLocale(locale: string | null): void { this.locale = locale; }
-  getApiKey(): string | null { return this.apiKey; }
-  setApiKey(key: string | null): void { this.apiKey = key; }
+  getLocale(): string | null { return auth.getLocale(); }
+  setLocale(locale: string | null): void { auth.setLocale(locale); }
+  getApiKey(): string | null { return auth.getApiKey(); }
+  setApiKey(key: string | null): void { auth.setApiKey(key); }
 }
 
 export {  };
-export { client };
+export { auth };

package/src/_api/generated/_cfg_accounts/index.ts

@@ -1,10 +1,10 @@
 // AUTO-GENERATED by django_generator / ts_extras.wrapper
 // Group barrel. DO NOT EDIT — re-run `make gen`.
 
-// Wrapper class + per-group SDK re-exports
-export { API, type APIOptions,  } from './api';
+// Wrapper class + per-group SDK re-exports + global auth.
+export { API, type APIOptions, auth,  } from './api';
 
-// Shared utilities (storage / errors / logger / validation events)
+// Shared utilities.
 export {
   type StorageAdapter,
   LocalStorageAdapter,
@@ -25,5 +25,5 @@ export {
   type ValidationErrorEvent,
 } from '../helpers';
 
-// Generated artifacts (Hey API)
+// Generated artifacts (Hey API).
 export type * from '../types.gen';

package/src/_api/generated/_cfg_centrifugo/api.ts

@@ -1,36 +1,16 @@
 // AUTO-GENERATED by django_generator / ts_extras.wrapper
-// Self-contained API wrapper for this group. DO NOT EDIT — re-run `make gen`.
+// Thin per-group proxy over the global `auth` store. All actual auth
+// wiring lives in `helpers/auth.ts` (one interceptor, one source of
+// truth). DO NOT EDIT — re-run `make gen`.
 
-import { client } from '../client.gen';
-import type { StorageAdapter } from '../helpers/storage';
-import { LocalStorageAdapter } from '../helpers/storage';
+import { auth } from '../helpers/auth';
 import { APILogger, type LoggerConfig } from '../helpers/logger';
 
 
 
 
-const ACCESS_KEY = 'cfg.access_token';
-const REFRESH_KEY = 'cfg.refresh_token';
-
-
-
-/** Auto-detect locale from cookie NEXT_LOCALE or navigator.language. */
-function detectLocale(): string | null {
-  try {
-    if (typeof document !== 'undefined') {
-      const m = document.cookie.match(/(?:^|;\s*)NEXT_LOCALE=([^;]*)/);
-      if (m) return decodeURIComponent(m[1]);
-    }
-    if (typeof navigator !== 'undefined' && navigator.language) {
-      return navigator.language;
-    }
-  } catch {}
-  return null;
-}
 
 export interface APIOptions {
-  /** Override storage backend (LocalStorage by default; Memory for SSR/tests). */
-  storage?: StorageAdapter;
   /** Logger config (defaults to dev-only). */
   logger?: Partial<LoggerConfig>;
   /** Locale for `Accept-Language`. If omitted, auto-detected from cookie/navigator. */
@@ -42,79 +22,46 @@ export interface APIOptions {
 }
 
 /**
- * Self-contained API wrapper for this group.
+ * Per-group ergonomic facade.
  *
- * Each group has its own client + interceptor + token store. The interceptor
- * automatically attaches:
- *   - `Authorization: Bearer <jwt>` from storage
- *   - `Accept-Language` from `opts.locale` or `NEXT_LOCALE` cookie
- *   - `X-API-Key` from `opts.apiKey` or `NEXT_PUBLIC_API_KEY`
- *   - `credentials: 'include'` for Django session/CSRF cookies (toggle via opts)
+ * Calling `setToken/setApiKey/setLocale/setBaseUrl` proxies to the
+ * global `auth` store — the change applies to **every** group's API
+ * instance because they share the same HTTP client and interceptor.
+ *
+ * Use the global `auth` object directly when you don't need a group
+ * facade: `import { auth } from '@your/api'; auth.setToken(jwt);`
  */
 export class API {
-  private baseUrl: string;
-  private storage: StorageAdapter;
-  private locale: string | null;
-  private apiKey: string | null;
   readonly logger: APILogger;
 
 
 
-  constructor(baseUrl: string, opts: APIOptions = {}) {
-    this.baseUrl = baseUrl.replace(/\/$/, '');
-    this.storage = opts.storage ?? new LocalStorageAdapter();
+  constructor(_baseUrl?: string, opts: APIOptions = {}) {
     this.logger = new APILogger(opts.logger);
-    this.locale = opts.locale ?? null;
-    this.apiKey = opts.apiKey ?? (typeof process !== 'undefined' ? (process.env?.NEXT_PUBLIC_API_KEY ?? null) : null);
-
-    const credentials: RequestCredentials = (opts.withCredentials ?? true) ? 'include' : 'same-origin';
-    client.setConfig({ baseUrl: this.baseUrl, credentials });
-
-    client.interceptors.request.use((request) => {
-      const access = this.getToken();
-      if (access) request.headers.set('Authorization', `Bearer ${access}`);
-
-      const locale = this.locale ?? detectLocale();
-      if (locale) request.headers.set('Accept-Language', locale);
-
-      if (this.apiKey) request.headers.set('X-API-Key', this.apiKey);
-
-      return request;
-    });
-
-
+    if (_baseUrl) auth.setBaseUrl(_baseUrl);
+    if (opts.locale !== undefined) auth.setLocale(opts.locale);
+    if (opts.apiKey !== undefined) auth.setApiKey(opts.apiKey);
+    if (opts.withCredentials !== undefined) auth.setWithCredentials(opts.withCredentials);
   }
 
   // ── Base URL ────────────────────────────────────────────────────────────
-  getBaseUrl(): string { return this.baseUrl; }
-  setBaseUrl(url: string): void {
-    this.baseUrl = url.replace(/\/$/, '');
-    client.setConfig({ baseUrl: this.baseUrl });
-  }
+  getBaseUrl(): string { return auth.getBaseUrl(); }
+  setBaseUrl(url: string): void { auth.setBaseUrl(url); }
 
   // ── Tokens ──────────────────────────────────────────────────────────────
-  getToken(): string | null { return this.storage.getItem(ACCESS_KEY); }
-  setToken(token: string | null): void {
-    if (token) this.storage.setItem(ACCESS_KEY, token);
-    else this.storage.removeItem(ACCESS_KEY);
-  }
-  getRefreshToken(): string | null { return this.storage.getItem(REFRESH_KEY); }
-  setRefreshToken(token: string | null): void {
-    if (token) this.storage.setItem(REFRESH_KEY, token);
-    else this.storage.removeItem(REFRESH_KEY);
-  }
-  clearToken(): void {
-    this.storage.removeItem(ACCESS_KEY);
-    this.storage.removeItem(REFRESH_KEY);
-  }
-  isAuthenticated(): boolean { return this.getToken() !== null; }
+  getToken(): string | null { return auth.getToken(); }
+  setToken(token: string | null): void { auth.setToken(token); }
+  getRefreshToken(): string | null { return auth.getRefreshToken(); }
+  setRefreshToken(token: string | null): void { auth.setRefreshToken(token); }
+  clearToken(): void { auth.clearTokens(); }
+  isAuthenticated(): boolean { return auth.isAuthenticated(); }
 
   // ── Locale / API key ────────────────────────────────────────────────────
-  getLocale(): string | null { return this.locale ?? detectLocale(); }
-  setLocale(locale: string | null): void { this.locale = locale; }
-  getApiKey(): string | null { return this.apiKey; }
-  setApiKey(key: string | null): void { this.apiKey = key; }
+  getLocale(): string | null { return auth.getLocale(); }
+  setLocale(locale: string | null): void { auth.setLocale(locale); }
+  getApiKey(): string | null { return auth.getApiKey(); }
+  setApiKey(key: string | null): void { auth.setApiKey(key); }
 }
 
 export {  };
-export { client };
+export { auth };

package/src/_api/generated/_cfg_centrifugo/index.ts

@@ -1,10 +1,10 @@
 // AUTO-GENERATED by django_generator / ts_extras.wrapper
 // Group barrel. DO NOT EDIT — re-run `make gen`.
 
-// Wrapper class + per-group SDK re-exports
-export { API, type APIOptions,  } from './api';
+// Wrapper class + per-group SDK re-exports + global auth.
+export { API, type APIOptions, auth,  } from './api';
 
-// Shared utilities (storage / errors / logger / validation events)
+// Shared utilities.
 export {
   type StorageAdapter,
   LocalStorageAdapter,
@@ -25,5 +25,5 @@ export {
   type ValidationErrorEvent,
 } from '../helpers';
 
-// Generated artifacts (Hey API)
+// Generated artifacts (Hey API).
 export type * from '../types.gen';

package/src/_api/generated/_cfg_totp/api.ts

@@ -1,36 +1,16 @@
 // AUTO-GENERATED by django_generator / ts_extras.wrapper
-// Self-contained API wrapper for this group. DO NOT EDIT — re-run `make gen`.
+// Thin per-group proxy over the global `auth` store. All actual auth
+// wiring lives in `helpers/auth.ts` (one interceptor, one source of
+// truth). DO NOT EDIT — re-run `make gen`.
 
-import { client } from '../client.gen';
-import type { StorageAdapter } from '../helpers/storage';
-import { LocalStorageAdapter } from '../helpers/storage';
+import { auth } from '../helpers/auth';
 import { APILogger, type LoggerConfig } from '../helpers/logger';
 
 
 
 
-const ACCESS_KEY = 'cfg.access_token';
-const REFRESH_KEY = 'cfg.refresh_token';
-
-
-
-/** Auto-detect locale from cookie NEXT_LOCALE or navigator.language. */
-function detectLocale(): string | null {
-  try {
-    if (typeof document !== 'undefined') {
-      const m = document.cookie.match(/(?:^|;\s*)NEXT_LOCALE=([^;]*)/);
-      if (m) return decodeURIComponent(m[1]);
-    }
-    if (typeof navigator !== 'undefined' && navigator.language) {
-      return navigator.language;
-    }
-  } catch {}
-  return null;
-}
 
 export interface APIOptions {
-  /** Override storage backend (LocalStorage by default; Memory for SSR/tests). */
-  storage?: StorageAdapter;
   /** Logger config (defaults to dev-only). */
   logger?: Partial<LoggerConfig>;
   /** Locale for `Accept-Language`. If omitted, auto-detected from cookie/navigator. */
@@ -42,79 +22,46 @@ export interface APIOptions {
 }
 
 /**
- * Self-contained API wrapper for this group.
+ * Per-group ergonomic facade.
  *
- * Each group has its own client + interceptor + token store. The interceptor
- * automatically attaches:
- *   - `Authorization: Bearer <jwt>` from storage
- *   - `Accept-Language` from `opts.locale` or `NEXT_LOCALE` cookie
- *   - `X-API-Key` from `opts.apiKey` or `NEXT_PUBLIC_API_KEY`
- *   - `credentials: 'include'` for Django session/CSRF cookies (toggle via opts)
+ * Calling `setToken/setApiKey/setLocale/setBaseUrl` proxies to the
+ * global `auth` store — the change applies to **every** group's API
+ * instance because they share the same HTTP client and interceptor.
+ *
+ * Use the global `auth` object directly when you don't need a group
+ * facade: `import { auth } from '@your/api'; auth.setToken(jwt);`
  */
 export class API {
-  private baseUrl: string;
-  private storage: StorageAdapter;
-  private locale: string | null;
-  private apiKey: string | null;
   readonly logger: APILogger;
 
 
 
-  constructor(baseUrl: string, opts: APIOptions = {}) {
-    this.baseUrl = baseUrl.replace(/\/$/, '');
-    this.storage = opts.storage ?? new LocalStorageAdapter();
+  constructor(_baseUrl?: string, opts: APIOptions = {}) {
     this.logger = new APILogger(opts.logger);
-    this.locale = opts.locale ?? null;
-    this.apiKey = opts.apiKey ?? (typeof process !== 'undefined' ? (process.env?.NEXT_PUBLIC_API_KEY ?? null) : null);
-
-    const credentials: RequestCredentials = (opts.withCredentials ?? true) ? 'include' : 'same-origin';
-    client.setConfig({ baseUrl: this.baseUrl, credentials });
-
-    client.interceptors.request.use((request) => {
-      const access = this.getToken();
-      if (access) request.headers.set('Authorization', `Bearer ${access}`);
-
-      const locale = this.locale ?? detectLocale();
-      if (locale) request.headers.set('Accept-Language', locale);
-
-      if (this.apiKey) request.headers.set('X-API-Key', this.apiKey);
-
-      return request;
-    });
-
-
+    if (_baseUrl) auth.setBaseUrl(_baseUrl);
+    if (opts.locale !== undefined) auth.setLocale(opts.locale);
+    if (opts.apiKey !== undefined) auth.setApiKey(opts.apiKey);
+    if (opts.withCredentials !== undefined) auth.setWithCredentials(opts.withCredentials);
   }
 
   // ── Base URL ────────────────────────────────────────────────────────────
-  getBaseUrl(): string { return this.baseUrl; }
-  setBaseUrl(url: string): void {
-    this.baseUrl = url.replace(/\/$/, '');
-    client.setConfig({ baseUrl: this.baseUrl });
-  }
+  getBaseUrl(): string { return auth.getBaseUrl(); }
+  setBaseUrl(url: string): void { auth.setBaseUrl(url); }
 
   // ── Tokens ──────────────────────────────────────────────────────────────
-  getToken(): string | null { return this.storage.getItem(ACCESS_KEY); }
-  setToken(token: string | null): void {
-    if (token) this.storage.setItem(ACCESS_KEY, token);
-    else this.storage.removeItem(ACCESS_KEY);
-  }
-  getRefreshToken(): string | null { return this.storage.getItem(REFRESH_KEY); }
-  setRefreshToken(token: string | null): void {
-    if (token) this.storage.setItem(REFRESH_KEY, token);
-    else this.storage.removeItem(REFRESH_KEY);
-  }
-  clearToken(): void {
-    this.storage.removeItem(ACCESS_KEY);
-    this.storage.removeItem(REFRESH_KEY);
-  }
-  isAuthenticated(): boolean { return this.getToken() !== null; }
+  getToken(): string | null { return auth.getToken(); }
+  setToken(token: string | null): void { auth.setToken(token); }
+  getRefreshToken(): string | null { return auth.getRefreshToken(); }
+  setRefreshToken(token: string | null): void { auth.setRefreshToken(token); }
+  clearToken(): void { auth.clearTokens(); }
+  isAuthenticated(): boolean { return auth.isAuthenticated(); }
 
   // ── Locale / API key ────────────────────────────────────────────────────
-  getLocale(): string | null { return this.locale ?? detectLocale(); }
-  setLocale(locale: string | null): void { this.locale = locale; }
-  getApiKey(): string | null { return this.apiKey; }
-  setApiKey(key: string | null): void { this.apiKey = key; }
+  getLocale(): string | null { return auth.getLocale(); }
+  setLocale(locale: string | null): void { auth.setLocale(locale); }
+  getApiKey(): string | null { return auth.getApiKey(); }
+  setApiKey(key: string | null): void { auth.setApiKey(key); }
 }
 
 export {  };
-export { client };
+export { auth };

package/src/_api/generated/_cfg_totp/index.ts

@@ -1,10 +1,10 @@
 // AUTO-GENERATED by django_generator / ts_extras.wrapper
 // Group barrel. DO NOT EDIT — re-run `make gen`.
 
-// Wrapper class + per-group SDK re-exports
-export { API, type APIOptions,  } from './api';
+// Wrapper class + per-group SDK re-exports + global auth.
+export { API, type APIOptions, auth,  } from './api';
 
-// Shared utilities (storage / errors / logger / validation events)
+// Shared utilities.
 export {
   type StorageAdapter,
   LocalStorageAdapter,
@@ -25,5 +25,5 @@ export {
   type ValidationErrorEvent,
 } from '../helpers';
 
-// Generated artifacts (Hey API)
+// Generated artifacts (Hey API).
 export type * from '../types.gen';

package/src/_api/generated/client.gen.ts

@@ -14,3 +14,7 @@ import type { ClientOptions as ClientOptions2 } from './types.gen';
 export type CreateClientConfig<T extends ClientOptions = ClientOptions2> = (override?: Config<ClientOptions & T>) => Config<Required<ClientOptions> & T>;
 
 export const client = createClient(createConfig<ClientOptions2>({ baseUrl: 'http://localhost:8000' }));
+
+// auto-init: install auth on client
+import { installAuthOnClient } from './helpers/auth';
+installAuthOnClient(client);