@djangocfg/api 2.1.599 → 2.1.601

package/dist/storage.cjs

@@ -42,6 +42,7 @@ var CFG_KEYS = {
   redirectUrlTs: k("cfg.auth.redirect_url_ts", "session", true),
   oauthState: k("cfg.auth.oauth_state", "session", true),
   oauthProvider: k("cfg.auth.oauth_provider", "session", true),
+  oauthProviders: k("cfg.auth.oauth_providers", "session", false),
   profileCache: k("cfg.profile.cache", "local", true),
   monitorSessionId: k("cfg.monitor.session_id", "local", false),
   monitorSessionCookie: k("cfg.monitor.session_id", "cookie", false),

package/dist/storage.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/storage.ts","../src/_api/generated/helpers/keys.ts"],"sourcesContent":["/**\n * `@djangocfg/api/storage` — the browser-storage key registry on its own.\n *\n * Zero dependencies and no client: packages that only need a key, a guarded\n * read/write or `createStorage('<owner>')` import this, not the generated SDK.\n * The source is the generated `helpers/keys.ts`.\n */\nexport {\n  CFG_FAMILIES,\n  CFG_KEYS,\n  cfgStorage,\n  createStorage,\n  normalizeSegment,\n} from './_api/generated/helpers/keys';\nexport type {\n  FamilySpec,\n  GuardedStorage,\n  KeySpec,\n  KeyStore,\n  StorageOptions,\n} from './_api/generated/helpers/keys';\n","// AUTO-GENERATED by django_generator / ts_extras.wrapper\n// Browser-storage key registry: one scheme, guarded access.\n// DO NOT EDIT — re-run `make gen`.\n//\n// Rules for agents and apps: @docs/STORAGE_KEYS.md in @djangocfg/api.\n//\n// Scheme: `<owner>.<area>.<name>` — lower case, dots between levels,\n// `snake_case` inside a level. The framework's owner is `cfg`; an app picks its\n// own with `createStorage('<owner>')`. Third-party keys (a library's own\n// prefix, `NEXT_LOCALE`) are not ours to rename and stay as they are.\n\nexport type KeyStore = 'local' | 'session' | 'cookie';\n\nexport interface KeySpec {\n  /** The canonical key. */\n  readonly key: string;\n  readonly store: KeyStore;\n  /** Removed by `clearAll()` (sign-out). Preferences are kept. */\n  readonly personal: boolean;\n}\n\nexport interface FamilySpec {\n  /** Canonical prefix ending in a dot; the id is appended in normalised form. */\n  readonly prefix: string;\n  readonly store: 'local' | 'session';\n  readonly personal: boolean;\n}\n\nconst k = (\n  key: string,\n  store: KeyStore,\n  personal: boolean,\n): KeySpec => ({ key, store, personal });\n\nconst f = (\n  prefix: string,\n  store: 'local' | 'session',\n  personal: boolean,\n): FamilySpec => ({ prefix, store, personal });\n\n/** Every key the framework writes. No legacy spellings are read: old keys are simply ignored. */\nexport const CFG_KEYS = {\n  accessToken: k('cfg.auth.access_token', 'local', true),\n  refreshToken: k('cfg.auth.refresh_token', 'local', true),\n  apiKey: k('cfg.auth.api_key', 'local', true),\n  email: k('cfg.auth.email', 'local', false),\n  emailTs: k('cfg.auth.email_ts', 'local', false),\n  redirectUrl: k('cfg.auth.redirect_url', 'session', true),\n  redirectUrlTs: k('cfg.auth.redirect_url_ts', 'session', true),\n  oauthState: k('cfg.auth.oauth_state', 'session', true),\n  oauthProvider: k('cfg.auth.oauth_provider', 'session', true),\n  profileCache: k('cfg.profile.cache', 'local', true),\n  monitorSessionId: k('cfg.monitor.session_id', 'local', false),\n  monitorSessionCookie: k('cfg.monitor.session_id', 'cookie', false),\n  monitorDebug: k('cfg.monitor.debug', 'local', false),\n  uiTabId: k('cfg.ui.tab_id', 'session', false),\n  uiRouterSerial: k('cfg.ui.router_serial', 'session', false),\n  uiState: k('cfg.ui.state', 'local', false),\n  chatSpeechLanguage: k('cfg.chat.speech_language', 'local', false),\n  chatRecentTools: k('cfg.chat.recent_tools', 'local', false),\n  formsSpeechDebug: k('cfg.forms.speech_debug', 'local', false),\n  formsSpeechPrefs: k('cfg.forms.speech_prefs', 'local', false),\n  agentPlaygroundApiKeyId: k('cfg.agent.playground_api_key_id', 'session', true),\n  agentPlaygroundBearer: k('cfg.agent.playground_bearer', 'session', true),\n  agentEndpointDoc: k('cfg.agent.endpoint_doc', 'session', false),\n} as const satisfies Record<string, KeySpec>;\n\n/** Keys with a caller-supplied id part: one per room, tree, endpoint. */\nexport const CFG_FAMILIES = {\n  chatDraft: f('cfg.chat.draft.', 'session', true),\n  dataTree: f('cfg.data.tree.', 'local', false),\n  agentEndpointDraft: f('cfg.agent.endpoint_draft.', 'local', false),\n} as const satisfies Record<string, FamilySpec>;\n\nconst OWNER_RE = /^[a-z][a-z0-9_]*$/;\n\n/** One segment of a key: lower case, `[a-z0-9_]`, anything else folded to `_`. */\nexport function normalizeSegment(raw: string): string {\n  return raw\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9_]+/g, '_')\n    .replace(/^_+|_+$/g, '');\n}\n\nexport interface StorageOptions {\n  /** Named keys of this owner. */\n  readonly keys?: Readonly<Record<string, KeySpec>>;\n  readonly families?: Readonly<Record<string, FamilySpec>>;\n  /** Cookie lifetime for the `cookie` store. Default 30 days. */\n  readonly cookieMaxAgeSeconds?: number;\n}\n\nexport interface GuardedStorage {\n  readonly owner: string;\n  /** Builds `<owner>.<part>.<part>` from free-form parts; throws if a part is empty. */\n  key(...parts: string[]): string;\n  /** Builds a family member key: the prefix plus the normalised id. */\n  familyKey(family: FamilySpec, id: string): string;\n  /** `^(cfg|<owner>)(\\.[a-z0-9_]+)+$`. */\n  isValid(key: string): boolean;\n  read(key: string, store?: KeyStore): string | null;\n  /** True when the value reached the browser's storage; false means it is held in memory for this page only. */\n  write(key: string, value: string, store?: KeyStore): boolean;\n  /** Removes the key. */\n  remove(key: string, store?: KeyStore): void;\n  readJSON<T>(key: string, store?: KeyStore): T | null;\n  writeJSON(key: string, value: unknown, store?: KeyStore): boolean;\n  /** Keys this owner holds in `store`. */\n  keys(store?: Exclude<KeyStore, 'cookie'>): string[];\n  /** Sign-out: removes the `personal` keys. `{ all: true }` removes everything under this owner. */\n  clearAll(options?: { all?: boolean }): void;\n  /** Cross-tab: calls `listener` with the new value when ANOTHER tab changes `key`. Cookies fire no events. */\n  onChange(key: string, listener: (value: string | null) => void, store?: Exclude<KeyStore, 'cookie'>): () => void;\n}\n\nconst hasWindow = () => typeof window !== 'undefined';\n\nfunction nativeStorage(store: 'local' | 'session'): Storage | null {\n  if (!hasWindow()) return null;\n  try {\n    return store === 'session' ? window.sessionStorage : window.localStorage;\n  } catch {\n    return null;\n  }\n}\n\nfunction cookieNames(): string[] {\n  if (!hasWindow()) return [];\n  try {\n    return document.cookie\n      .split('; ')\n      .map((part) => decodeURIComponent(part.split('=')[0] ?? ''))\n      .filter(Boolean);\n  } catch {\n    return [];\n  }\n}\n\nexport function createStorage(owner: string, options: StorageOptions = {}): GuardedStorage {\n  if (!OWNER_RE.test(owner)) {\n    throw new TypeError(`createStorage: owner \"${owner}\" must match ${OWNER_RE}`);\n  }\n  const prefix = `${owner}.`;\n  const pattern = owner === 'cfg' ? /^cfg(\\.[a-z0-9_]+)+$/ : new RegExp(`^(cfg|${owner})(\\\\.[a-z0-9_]+)+$`);\n  const cookieMaxAge = options.cookieMaxAgeSeconds ?? 60 * 60 * 24 * 30;\n  const specs = Object.values(options.keys ?? {});\n  const families = Object.values(options.families ?? {});\n  const specByKey = new Map<string, KeySpec[]>();\n  for (const spec of specs) specByKey.set(spec.key, [...(specByKey.get(spec.key) ?? []), spec]);\n  // Held in memory when the browser refuses a write (quota, private mode), so the page still works until reload.\n  const memory: Record<KeyStore, Map<string, string>> = {\n    local: new Map(),\n    session: new Map(),\n    cookie: new Map(),\n  };\n\n  const isValid = (key: string) => pattern.test(key);\n  const assertValid = (key: string) => {\n    if (!isValid(key)) throw new TypeError(`storage key \"${key}\" must match ${pattern}`);\n  };\n  const assertOwned = (key: string) => {\n    assertValid(key);\n    if (!key.startsWith(prefix)) throw new TypeError(`storage key \"${key}\" is not owned by \"${owner}\"`);\n  };\n\n  function rawGet(store: KeyStore, key: string): string | null {\n    if (!hasWindow()) return null;\n    if (store === 'cookie') {\n      try {\n        const escaped = encodeURIComponent(key).replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n        const match = document.cookie.match(new RegExp(`(?:^|;\\\\s*)${escaped}=([^;]*)`));\n        if (match?.[1] !== undefined) return decodeURIComponent(match[1]);\n      } catch {\n        /* fall through to memory */\n      }\n      return memory.cookie.get(key) ?? null;\n    }\n    try {\n      const value = nativeStorage(store)?.getItem(key) ?? null;\n      if (value !== null) return value;\n    } catch {\n      /* fall through to memory */\n    }\n    return memory[store].get(key) ?? null;\n  }\n\n  function rawSet(store: KeyStore, key: string, value: string): boolean {\n    if (!hasWindow()) return false;\n    try {\n      if (store === 'cookie') {\n        const secure = window.location.protocol === 'https:' ? '; Secure' : '';\n        document.cookie = `${encodeURIComponent(key)}=${encodeURIComponent(value)}; Path=/; Max-Age=${cookieMaxAge}; SameSite=Lax${secure}`;\n        if (rawGet('cookie', key) === value && !memory.cookie.has(key)) return true;\n        memory.cookie.set(key, value);\n        return false;\n      }\n      const native = nativeStorage(store);\n      if (!native) throw new Error('storage unavailable');\n      native.setItem(key, value);\n      memory[store].delete(key);\n      return true;\n    } catch {\n      memory[store].set(key, value);\n      return false;\n    }\n  }\n\n  function rawRemove(store: KeyStore, key: string): void {\n    memory[store].delete(key);\n    if (!hasWindow()) return;\n    try {\n      if (store === 'cookie') {\n        const secure = window.location.protocol === 'https:' ? '; Secure' : '';\n        document.cookie = `${encodeURIComponent(key)}=; Path=/; Max-Age=0; SameSite=Lax${secure}`;\n      } else {\n        nativeStorage(store)?.removeItem(key);\n      }\n    } catch {\n      /* ignore */\n    }\n  }\n\n  function resolveStore(key: string, store?: KeyStore): KeyStore {\n    return store ?? specByKey.get(key)?.[0]?.store ?? 'local';\n  }\n\n  function listKeys(store: 'local' | 'session', startsWith: string): string[] {\n    const out: string[] = [];\n    try {\n      const native = nativeStorage(store);\n      if (native) {\n        for (let i = 0; i < native.length; i += 1) {\n          const name = native.key(i);\n          if (name?.startsWith(startsWith)) out.push(name);\n        }\n      }\n    } catch {\n      /* ignore */\n    }\n    for (const name of memory[store].keys()) if (name.startsWith(startsWith) && !out.includes(name)) out.push(name);\n    return out;\n  }\n\n  const familyKey = (family: FamilySpec, id: string) => {\n    const part = normalizeSegment(id);\n    if (!part) throw new TypeError('storage family id is empty after normalisation');\n    return family.prefix + part;\n  };\n\n  const api: GuardedStorage = {\n    owner,\n    key(...parts) {\n      const segments = parts.map(normalizeSegment);\n      if (segments.length === 0 || segments.some((segment) => !segment)) {\n        throw new TypeError(`storage key parts must be non-empty: ${JSON.stringify(parts)}`);\n      }\n      return `${prefix}${segments.join('.')}`;\n    },\n    familyKey,\n    isValid,\n    read(key, store) {\n      assertValid(key);\n      const target = resolveStore(key, store);\n      return rawGet(target, key);\n    },\n    write(key, value, store) {\n      assertOwned(key);\n      const target = resolveStore(key, store);\n      return rawSet(target, key, value);\n    },\n    remove(key, store) {\n      assertOwned(key);\n      const target = resolveStore(key, store);\n      rawRemove(target, key);\n    },\n    readJSON<T>(key: string, store?: KeyStore): T | null {\n      const raw = api.read(key, store);\n      if (raw === null) return null;\n      try {\n        return JSON.parse(raw) as T;\n      } catch {\n        return null;\n      }\n    },\n    writeJSON(key, value, store) {\n      return api.write(key, JSON.stringify(value), store);\n    },\n    keys(store = 'local') {\n      return listKeys(store, prefix);\n    },\n    clearAll({ all = false } = {}) {\n      for (const spec of specs) {\n        if (!all && !spec.personal) continue;\n        rawRemove(spec.store, spec.key);\n      }\n      for (const family of families) {\n        if (!all && !family.personal) continue;\n        for (const name of listKeys(family.store, family.prefix)) rawRemove(family.store, name);\n      }\n      if (all) {\n        for (const store of ['local', 'session'] as const) {\n          for (const name of listKeys(store, prefix)) rawRemove(store, name);\n        }\n        for (const name of cookieNames()) if (name.startsWith(prefix)) rawRemove('cookie', name);\n      }\n    },\n    onChange(key, listener, store = 'local') {\n      assertValid(key);\n      if (!hasWindow()) return () => {};\n      const handler = (event: StorageEvent) => {\n        if (event.storageArea !== nativeStorage(store)) return;\n        if (event.key === null || event.key === key) listener(event.key === null ? null : event.newValue);\n      };\n      window.addEventListener('storage', handler);\n      return () => window.removeEventListener('storage', handler);\n    },\n  };\n  return api;\n}\n\n/** The framework's own storage: every `cfg.*` key. */\nexport const cfgStorage: GuardedStorage = createStorage('cfg', {\n  keys: CFG_KEYS,\n  families: CFG_FAMILIES,\n});\n\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/storage.ts","../src/_api/generated/helpers/keys.ts"],"sourcesContent":["/**\n * `@djangocfg/api/storage` — the browser-storage key registry on its own.\n *\n * Zero dependencies and no client: packages that only need a key, a guarded\n * read/write or `createStorage('<owner>')` import this, not the generated SDK.\n * The source is the generated `helpers/keys.ts`.\n */\nexport {\n  CFG_FAMILIES,\n  CFG_KEYS,\n  cfgStorage,\n  createStorage,\n  normalizeSegment,\n} from './_api/generated/helpers/keys';\nexport type {\n  FamilySpec,\n  GuardedStorage,\n  KeySpec,\n  KeyStore,\n  StorageOptions,\n} from './_api/generated/helpers/keys';\n","// AUTO-GENERATED by django_generator / ts_extras.wrapper\n// Browser-storage key registry: one scheme, guarded access.\n// DO NOT EDIT — re-run `make gen`.\n//\n// Rules for agents and apps: @docs/STORAGE_KEYS.md in @djangocfg/api.\n//\n// Scheme: `<owner>.<area>.<name>` — lower case, dots between levels,\n// `snake_case` inside a level. The framework's owner is `cfg`; an app picks its\n// own with `createStorage('<owner>')`. Third-party keys (a library's own\n// prefix, `NEXT_LOCALE`) are not ours to rename and stay as they are.\n\nexport type KeyStore = 'local' | 'session' | 'cookie';\n\nexport interface KeySpec {\n  /** The canonical key. */\n  readonly key: string;\n  readonly store: KeyStore;\n  /** Removed by `clearAll()` (sign-out). Preferences are kept. */\n  readonly personal: boolean;\n}\n\nexport interface FamilySpec {\n  /** Canonical prefix ending in a dot; the id is appended in normalised form. */\n  readonly prefix: string;\n  readonly store: 'local' | 'session';\n  readonly personal: boolean;\n}\n\nconst k = (\n  key: string,\n  store: KeyStore,\n  personal: boolean,\n): KeySpec => ({ key, store, personal });\n\nconst f = (\n  prefix: string,\n  store: 'local' | 'session',\n  personal: boolean,\n): FamilySpec => ({ prefix, store, personal });\n\n/** Every key the framework writes. No legacy spellings are read: old keys are simply ignored. */\nexport const CFG_KEYS = {\n  accessToken: k('cfg.auth.access_token', 'local', true),\n  refreshToken: k('cfg.auth.refresh_token', 'local', true),\n  apiKey: k('cfg.auth.api_key', 'local', true),\n  email: k('cfg.auth.email', 'local', false),\n  emailTs: k('cfg.auth.email_ts', 'local', false),\n  redirectUrl: k('cfg.auth.redirect_url', 'session', true),\n  redirectUrlTs: k('cfg.auth.redirect_url_ts', 'session', true),\n  oauthState: k('cfg.auth.oauth_state', 'session', true),\n  oauthProvider: k('cfg.auth.oauth_provider', 'session', true),\n  oauthProviders: k('cfg.auth.oauth_providers', 'session', false),\n  profileCache: k('cfg.profile.cache', 'local', true),\n  monitorSessionId: k('cfg.monitor.session_id', 'local', false),\n  monitorSessionCookie: k('cfg.monitor.session_id', 'cookie', false),\n  monitorDebug: k('cfg.monitor.debug', 'local', false),\n  uiTabId: k('cfg.ui.tab_id', 'session', false),\n  uiRouterSerial: k('cfg.ui.router_serial', 'session', false),\n  uiState: k('cfg.ui.state', 'local', false),\n  chatSpeechLanguage: k('cfg.chat.speech_language', 'local', false),\n  chatRecentTools: k('cfg.chat.recent_tools', 'local', false),\n  formsSpeechDebug: k('cfg.forms.speech_debug', 'local', false),\n  formsSpeechPrefs: k('cfg.forms.speech_prefs', 'local', false),\n  agentPlaygroundApiKeyId: k('cfg.agent.playground_api_key_id', 'session', true),\n  agentPlaygroundBearer: k('cfg.agent.playground_bearer', 'session', true),\n  agentEndpointDoc: k('cfg.agent.endpoint_doc', 'session', false),\n} as const satisfies Record<string, KeySpec>;\n\n/** Keys with a caller-supplied id part: one per room, tree, endpoint. */\nexport const CFG_FAMILIES = {\n  chatDraft: f('cfg.chat.draft.', 'session', true),\n  dataTree: f('cfg.data.tree.', 'local', false),\n  agentEndpointDraft: f('cfg.agent.endpoint_draft.', 'local', false),\n} as const satisfies Record<string, FamilySpec>;\n\nconst OWNER_RE = /^[a-z][a-z0-9_]*$/;\n\n/** One segment of a key: lower case, `[a-z0-9_]`, anything else folded to `_`. */\nexport function normalizeSegment(raw: string): string {\n  return raw\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9_]+/g, '_')\n    .replace(/^_+|_+$/g, '');\n}\n\nexport interface StorageOptions {\n  /** Named keys of this owner. */\n  readonly keys?: Readonly<Record<string, KeySpec>>;\n  readonly families?: Readonly<Record<string, FamilySpec>>;\n  /** Cookie lifetime for the `cookie` store. Default 30 days. */\n  readonly cookieMaxAgeSeconds?: number;\n}\n\nexport interface GuardedStorage {\n  readonly owner: string;\n  /** Builds `<owner>.<part>.<part>` from free-form parts; throws if a part is empty. */\n  key(...parts: string[]): string;\n  /** Builds a family member key: the prefix plus the normalised id. */\n  familyKey(family: FamilySpec, id: string): string;\n  /** `^(cfg|<owner>)(\\.[a-z0-9_]+)+$`. */\n  isValid(key: string): boolean;\n  read(key: string, store?: KeyStore): string | null;\n  /** True when the value reached the browser's storage; false means it is held in memory for this page only. */\n  write(key: string, value: string, store?: KeyStore): boolean;\n  /** Removes the key. */\n  remove(key: string, store?: KeyStore): void;\n  readJSON<T>(key: string, store?: KeyStore): T | null;\n  writeJSON(key: string, value: unknown, store?: KeyStore): boolean;\n  /** Keys this owner holds in `store`. */\n  keys(store?: Exclude<KeyStore, 'cookie'>): string[];\n  /** Sign-out: removes the `personal` keys. `{ all: true }` removes everything under this owner. */\n  clearAll(options?: { all?: boolean }): void;\n  /** Cross-tab: calls `listener` with the new value when ANOTHER tab changes `key`. Cookies fire no events. */\n  onChange(key: string, listener: (value: string | null) => void, store?: Exclude<KeyStore, 'cookie'>): () => void;\n}\n\nconst hasWindow = () => typeof window !== 'undefined';\n\nfunction nativeStorage(store: 'local' | 'session'): Storage | null {\n  if (!hasWindow()) return null;\n  try {\n    return store === 'session' ? window.sessionStorage : window.localStorage;\n  } catch {\n    return null;\n  }\n}\n\nfunction cookieNames(): string[] {\n  if (!hasWindow()) return [];\n  try {\n    return document.cookie\n      .split('; ')\n      .map((part) => decodeURIComponent(part.split('=')[0] ?? ''))\n      .filter(Boolean);\n  } catch {\n    return [];\n  }\n}\n\nexport function createStorage(owner: string, options: StorageOptions = {}): GuardedStorage {\n  if (!OWNER_RE.test(owner)) {\n    throw new TypeError(`createStorage: owner \"${owner}\" must match ${OWNER_RE}`);\n  }\n  const prefix = `${owner}.`;\n  const pattern = owner === 'cfg' ? /^cfg(\\.[a-z0-9_]+)+$/ : new RegExp(`^(cfg|${owner})(\\\\.[a-z0-9_]+)+$`);\n  const cookieMaxAge = options.cookieMaxAgeSeconds ?? 60 * 60 * 24 * 30;\n  const specs = Object.values(options.keys ?? {});\n  const families = Object.values(options.families ?? {});\n  const specByKey = new Map<string, KeySpec[]>();\n  for (const spec of specs) specByKey.set(spec.key, [...(specByKey.get(spec.key) ?? []), spec]);\n  // Held in memory when the browser refuses a write (quota, private mode), so the page still works until reload.\n  const memory: Record<KeyStore, Map<string, string>> = {\n    local: new Map(),\n    session: new Map(),\n    cookie: new Map(),\n  };\n\n  const isValid = (key: string) => pattern.test(key);\n  const assertValid = (key: string) => {\n    if (!isValid(key)) throw new TypeError(`storage key \"${key}\" must match ${pattern}`);\n  };\n  const assertOwned = (key: string) => {\n    assertValid(key);\n    if (!key.startsWith(prefix)) throw new TypeError(`storage key \"${key}\" is not owned by \"${owner}\"`);\n  };\n\n  function rawGet(store: KeyStore, key: string): string | null {\n    if (!hasWindow()) return null;\n    if (store === 'cookie') {\n      try {\n        const escaped = encodeURIComponent(key).replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n        const match = document.cookie.match(new RegExp(`(?:^|;\\\\s*)${escaped}=([^;]*)`));\n        if (match?.[1] !== undefined) return decodeURIComponent(match[1]);\n      } catch {\n        /* fall through to memory */\n      }\n      return memory.cookie.get(key) ?? null;\n    }\n    try {\n      const value = nativeStorage(store)?.getItem(key) ?? null;\n      if (value !== null) return value;\n    } catch {\n      /* fall through to memory */\n    }\n    return memory[store].get(key) ?? null;\n  }\n\n  function rawSet(store: KeyStore, key: string, value: string): boolean {\n    if (!hasWindow()) return false;\n    try {\n      if (store === 'cookie') {\n        const secure = window.location.protocol === 'https:' ? '; Secure' : '';\n        document.cookie = `${encodeURIComponent(key)}=${encodeURIComponent(value)}; Path=/; Max-Age=${cookieMaxAge}; SameSite=Lax${secure}`;\n        if (rawGet('cookie', key) === value && !memory.cookie.has(key)) return true;\n        memory.cookie.set(key, value);\n        return false;\n      }\n      const native = nativeStorage(store);\n      if (!native) throw new Error('storage unavailable');\n      native.setItem(key, value);\n      memory[store].delete(key);\n      return true;\n    } catch {\n      memory[store].set(key, value);\n      return false;\n    }\n  }\n\n  function rawRemove(store: KeyStore, key: string): void {\n    memory[store].delete(key);\n    if (!hasWindow()) return;\n    try {\n      if (store === 'cookie') {\n        const secure = window.location.protocol === 'https:' ? '; Secure' : '';\n        document.cookie = `${encodeURIComponent(key)}=; Path=/; Max-Age=0; SameSite=Lax${secure}`;\n      } else {\n        nativeStorage(store)?.removeItem(key);\n      }\n    } catch {\n      /* ignore */\n    }\n  }\n\n  function resolveStore(key: string, store?: KeyStore): KeyStore {\n    return store ?? specByKey.get(key)?.[0]?.store ?? 'local';\n  }\n\n  function listKeys(store: 'local' | 'session', startsWith: string): string[] {\n    const out: string[] = [];\n    try {\n      const native = nativeStorage(store);\n      if (native) {\n        for (let i = 0; i < native.length; i += 1) {\n          const name = native.key(i);\n          if (name?.startsWith(startsWith)) out.push(name);\n        }\n      }\n    } catch {\n      /* ignore */\n    }\n    for (const name of memory[store].keys()) if (name.startsWith(startsWith) && !out.includes(name)) out.push(name);\n    return out;\n  }\n\n  const familyKey = (family: FamilySpec, id: string) => {\n    const part = normalizeSegment(id);\n    if (!part) throw new TypeError('storage family id is empty after normalisation');\n    return family.prefix + part;\n  };\n\n  const api: GuardedStorage = {\n    owner,\n    key(...parts) {\n      const segments = parts.map(normalizeSegment);\n      if (segments.length === 0 || segments.some((segment) => !segment)) {\n        throw new TypeError(`storage key parts must be non-empty: ${JSON.stringify(parts)}`);\n      }\n      return `${prefix}${segments.join('.')}`;\n    },\n    familyKey,\n    isValid,\n    read(key, store) {\n      assertValid(key);\n      const target = resolveStore(key, store);\n      return rawGet(target, key);\n    },\n    write(key, value, store) {\n      assertOwned(key);\n      const target = resolveStore(key, store);\n      return rawSet(target, key, value);\n    },\n    remove(key, store) {\n      assertOwned(key);\n      const target = resolveStore(key, store);\n      rawRemove(target, key);\n    },\n    readJSON<T>(key: string, store?: KeyStore): T | null {\n      const raw = api.read(key, store);\n      if (raw === null) return null;\n      try {\n        return JSON.parse(raw) as T;\n      } catch {\n        return null;\n      }\n    },\n    writeJSON(key, value, store) {\n      return api.write(key, JSON.stringify(value), store);\n    },\n    keys(store = 'local') {\n      return listKeys(store, prefix);\n    },\n    clearAll({ all = false } = {}) {\n      for (const spec of specs) {\n        if (!all && !spec.personal) continue;\n        rawRemove(spec.store, spec.key);\n      }\n      for (const family of families) {\n        if (!all && !family.personal) continue;\n        for (const name of listKeys(family.store, family.prefix)) rawRemove(family.store, name);\n      }\n      if (all) {\n        for (const store of ['local', 'session'] as const) {\n          for (const name of listKeys(store, prefix)) rawRemove(store, name);\n        }\n        for (const name of cookieNames()) if (name.startsWith(prefix)) rawRemove('cookie', name);\n      }\n    },\n    onChange(key, listener, store = 'local') {\n      assertValid(key);\n      if (!hasWindow()) return () => {};\n      const handler = (event: StorageEvent) => {\n        if (event.storageArea !== nativeStorage(store)) return;\n        if (event.key === null || event.key === key) listener(event.key === null ? null : event.newValue);\n      };\n      window.addEventListener('storage', handler);\n      return () => window.removeEventListener('storage', handler);\n    },\n  };\n  return api;\n}\n\n/** The framework's own storage: every `cfg.*` key. */\nexport const cfgStorage: GuardedStorage = createStorage('cfg', {\n  keys: CFG_KEYS,\n  families: CFG_FAMILIES,\n});\n\n"],"mappings":"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","names":[]}

package/dist/storage.d.cts

@@ -23,6 +23,7 @@ declare const CFG_KEYS: {
     readonly redirectUrlTs: KeySpec;
     readonly oauthState: KeySpec;
     readonly oauthProvider: KeySpec;
+    readonly oauthProviders: KeySpec;
     readonly profileCache: KeySpec;
     readonly monitorSessionId: KeySpec;
     readonly monitorSessionCookie: KeySpec;

package/dist/storage.d.ts

@@ -23,6 +23,7 @@ declare const CFG_KEYS: {
     readonly redirectUrlTs: KeySpec;
     readonly oauthState: KeySpec;
     readonly oauthProvider: KeySpec;
+    readonly oauthProviders: KeySpec;
     readonly profileCache: KeySpec;
     readonly monitorSessionId: KeySpec;
     readonly monitorSessionCookie: KeySpec;

package/dist/storage.mjs

@@ -14,6 +14,7 @@ var CFG_KEYS = {
   redirectUrlTs: k("cfg.auth.redirect_url_ts", "session", true),
   oauthState: k("cfg.auth.oauth_state", "session", true),
   oauthProvider: k("cfg.auth.oauth_provider", "session", true),
+  oauthProviders: k("cfg.auth.oauth_providers", "session", false),
   profileCache: k("cfg.profile.cache", "local", true),
   monitorSessionId: k("cfg.monitor.session_id", "local", false),
   monitorSessionCookie: k("cfg.monitor.session_id", "cookie", false),

package/dist/storage.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/_api/generated/helpers/keys.ts"],"sourcesContent":["// AUTO-GENERATED by django_generator / ts_extras.wrapper\n// Browser-storage key registry: one scheme, guarded access.\n// DO NOT EDIT — re-run `make gen`.\n//\n// Rules for agents and apps: @docs/STORAGE_KEYS.md in @djangocfg/api.\n//\n// Scheme: `<owner>.<area>.<name>` — lower case, dots between levels,\n// `snake_case` inside a level. The framework's owner is `cfg`; an app picks its\n// own with `createStorage('<owner>')`. Third-party keys (a library's own\n// prefix, `NEXT_LOCALE`) are not ours to rename and stay as they are.\n\nexport type KeyStore = 'local' | 'session' | 'cookie';\n\nexport interface KeySpec {\n  /** The canonical key. */\n  readonly key: string;\n  readonly store: KeyStore;\n  /** Removed by `clearAll()` (sign-out). Preferences are kept. */\n  readonly personal: boolean;\n}\n\nexport interface FamilySpec {\n  /** Canonical prefix ending in a dot; the id is appended in normalised form. */\n  readonly prefix: string;\n  readonly store: 'local' | 'session';\n  readonly personal: boolean;\n}\n\nconst k = (\n  key: string,\n  store: KeyStore,\n  personal: boolean,\n): KeySpec => ({ key, store, personal });\n\nconst f = (\n  prefix: string,\n  store: 'local' | 'session',\n  personal: boolean,\n): FamilySpec => ({ prefix, store, personal });\n\n/** Every key the framework writes. No legacy spellings are read: old keys are simply ignored. */\nexport const CFG_KEYS = {\n  accessToken: k('cfg.auth.access_token', 'local', true),\n  refreshToken: k('cfg.auth.refresh_token', 'local', true),\n  apiKey: k('cfg.auth.api_key', 'local', true),\n  email: k('cfg.auth.email', 'local', false),\n  emailTs: k('cfg.auth.email_ts', 'local', false),\n  redirectUrl: k('cfg.auth.redirect_url', 'session', true),\n  redirectUrlTs: k('cfg.auth.redirect_url_ts', 'session', true),\n  oauthState: k('cfg.auth.oauth_state', 'session', true),\n  oauthProvider: k('cfg.auth.oauth_provider', 'session', true),\n  profileCache: k('cfg.profile.cache', 'local', true),\n  monitorSessionId: k('cfg.monitor.session_id', 'local', false),\n  monitorSessionCookie: k('cfg.monitor.session_id', 'cookie', false),\n  monitorDebug: k('cfg.monitor.debug', 'local', false),\n  uiTabId: k('cfg.ui.tab_id', 'session', false),\n  uiRouterSerial: k('cfg.ui.router_serial', 'session', false),\n  uiState: k('cfg.ui.state', 'local', false),\n  chatSpeechLanguage: k('cfg.chat.speech_language', 'local', false),\n  chatRecentTools: k('cfg.chat.recent_tools', 'local', false),\n  formsSpeechDebug: k('cfg.forms.speech_debug', 'local', false),\n  formsSpeechPrefs: k('cfg.forms.speech_prefs', 'local', false),\n  agentPlaygroundApiKeyId: k('cfg.agent.playground_api_key_id', 'session', true),\n  agentPlaygroundBearer: k('cfg.agent.playground_bearer', 'session', true),\n  agentEndpointDoc: k('cfg.agent.endpoint_doc', 'session', false),\n} as const satisfies Record<string, KeySpec>;\n\n/** Keys with a caller-supplied id part: one per room, tree, endpoint. */\nexport const CFG_FAMILIES = {\n  chatDraft: f('cfg.chat.draft.', 'session', true),\n  dataTree: f('cfg.data.tree.', 'local', false),\n  agentEndpointDraft: f('cfg.agent.endpoint_draft.', 'local', false),\n} as const satisfies Record<string, FamilySpec>;\n\nconst OWNER_RE = /^[a-z][a-z0-9_]*$/;\n\n/** One segment of a key: lower case, `[a-z0-9_]`, anything else folded to `_`. */\nexport function normalizeSegment(raw: string): string {\n  return raw\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9_]+/g, '_')\n    .replace(/^_+|_+$/g, '');\n}\n\nexport interface StorageOptions {\n  /** Named keys of this owner. */\n  readonly keys?: Readonly<Record<string, KeySpec>>;\n  readonly families?: Readonly<Record<string, FamilySpec>>;\n  /** Cookie lifetime for the `cookie` store. Default 30 days. */\n  readonly cookieMaxAgeSeconds?: number;\n}\n\nexport interface GuardedStorage {\n  readonly owner: string;\n  /** Builds `<owner>.<part>.<part>` from free-form parts; throws if a part is empty. */\n  key(...parts: string[]): string;\n  /** Builds a family member key: the prefix plus the normalised id. */\n  familyKey(family: FamilySpec, id: string): string;\n  /** `^(cfg|<owner>)(\\.[a-z0-9_]+)+$`. */\n  isValid(key: string): boolean;\n  read(key: string, store?: KeyStore): string | null;\n  /** True when the value reached the browser's storage; false means it is held in memory for this page only. */\n  write(key: string, value: string, store?: KeyStore): boolean;\n  /** Removes the key. */\n  remove(key: string, store?: KeyStore): void;\n  readJSON<T>(key: string, store?: KeyStore): T | null;\n  writeJSON(key: string, value: unknown, store?: KeyStore): boolean;\n  /** Keys this owner holds in `store`. */\n  keys(store?: Exclude<KeyStore, 'cookie'>): string[];\n  /** Sign-out: removes the `personal` keys. `{ all: true }` removes everything under this owner. */\n  clearAll(options?: { all?: boolean }): void;\n  /** Cross-tab: calls `listener` with the new value when ANOTHER tab changes `key`. Cookies fire no events. */\n  onChange(key: string, listener: (value: string | null) => void, store?: Exclude<KeyStore, 'cookie'>): () => void;\n}\n\nconst hasWindow = () => typeof window !== 'undefined';\n\nfunction nativeStorage(store: 'local' | 'session'): Storage | null {\n  if (!hasWindow()) return null;\n  try {\n    return store === 'session' ? window.sessionStorage : window.localStorage;\n  } catch {\n    return null;\n  }\n}\n\nfunction cookieNames(): string[] {\n  if (!hasWindow()) return [];\n  try {\n    return document.cookie\n      .split('; ')\n      .map((part) => decodeURIComponent(part.split('=')[0] ?? ''))\n      .filter(Boolean);\n  } catch {\n    return [];\n  }\n}\n\nexport function createStorage(owner: string, options: StorageOptions = {}): GuardedStorage {\n  if (!OWNER_RE.test(owner)) {\n    throw new TypeError(`createStorage: owner \"${owner}\" must match ${OWNER_RE}`);\n  }\n  const prefix = `${owner}.`;\n  const pattern = owner === 'cfg' ? /^cfg(\\.[a-z0-9_]+)+$/ : new RegExp(`^(cfg|${owner})(\\\\.[a-z0-9_]+)+$`);\n  const cookieMaxAge = options.cookieMaxAgeSeconds ?? 60 * 60 * 24 * 30;\n  const specs = Object.values(options.keys ?? {});\n  const families = Object.values(options.families ?? {});\n  const specByKey = new Map<string, KeySpec[]>();\n  for (const spec of specs) specByKey.set(spec.key, [...(specByKey.get(spec.key) ?? []), spec]);\n  // Held in memory when the browser refuses a write (quota, private mode), so the page still works until reload.\n  const memory: Record<KeyStore, Map<string, string>> = {\n    local: new Map(),\n    session: new Map(),\n    cookie: new Map(),\n  };\n\n  const isValid = (key: string) => pattern.test(key);\n  const assertValid = (key: string) => {\n    if (!isValid(key)) throw new TypeError(`storage key \"${key}\" must match ${pattern}`);\n  };\n  const assertOwned = (key: string) => {\n    assertValid(key);\n    if (!key.startsWith(prefix)) throw new TypeError(`storage key \"${key}\" is not owned by \"${owner}\"`);\n  };\n\n  function rawGet(store: KeyStore, key: string): string | null {\n    if (!hasWindow()) return null;\n    if (store === 'cookie') {\n      try {\n        const escaped = encodeURIComponent(key).replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n        const match = document.cookie.match(new RegExp(`(?:^|;\\\\s*)${escaped}=([^;]*)`));\n        if (match?.[1] !== undefined) return decodeURIComponent(match[1]);\n      } catch {\n        /* fall through to memory */\n      }\n      return memory.cookie.get(key) ?? null;\n    }\n    try {\n      const value = nativeStorage(store)?.getItem(key) ?? null;\n      if (value !== null) return value;\n    } catch {\n      /* fall through to memory */\n    }\n    return memory[store].get(key) ?? null;\n  }\n\n  function rawSet(store: KeyStore, key: string, value: string): boolean {\n    if (!hasWindow()) return false;\n    try {\n      if (store === 'cookie') {\n        const secure = window.location.protocol === 'https:' ? '; Secure' : '';\n        document.cookie = `${encodeURIComponent(key)}=${encodeURIComponent(value)}; Path=/; Max-Age=${cookieMaxAge}; SameSite=Lax${secure}`;\n        if (rawGet('cookie', key) === value && !memory.cookie.has(key)) return true;\n        memory.cookie.set(key, value);\n        return false;\n      }\n      const native = nativeStorage(store);\n      if (!native) throw new Error('storage unavailable');\n      native.setItem(key, value);\n      memory[store].delete(key);\n      return true;\n    } catch {\n      memory[store].set(key, value);\n      return false;\n    }\n  }\n\n  function rawRemove(store: KeyStore, key: string): void {\n    memory[store].delete(key);\n    if (!hasWindow()) return;\n    try {\n      if (store === 'cookie') {\n        const secure = window.location.protocol === 'https:' ? '; Secure' : '';\n        document.cookie = `${encodeURIComponent(key)}=; Path=/; Max-Age=0; SameSite=Lax${secure}`;\n      } else {\n        nativeStorage(store)?.removeItem(key);\n      }\n    } catch {\n      /* ignore */\n    }\n  }\n\n  function resolveStore(key: string, store?: KeyStore): KeyStore {\n    return store ?? specByKey.get(key)?.[0]?.store ?? 'local';\n  }\n\n  function listKeys(store: 'local' | 'session', startsWith: string): string[] {\n    const out: string[] = [];\n    try {\n      const native = nativeStorage(store);\n      if (native) {\n        for (let i = 0; i < native.length; i += 1) {\n          const name = native.key(i);\n          if (name?.startsWith(startsWith)) out.push(name);\n        }\n      }\n    } catch {\n      /* ignore */\n    }\n    for (const name of memory[store].keys()) if (name.startsWith(startsWith) && !out.includes(name)) out.push(name);\n    return out;\n  }\n\n  const familyKey = (family: FamilySpec, id: string) => {\n    const part = normalizeSegment(id);\n    if (!part) throw new TypeError('storage family id is empty after normalisation');\n    return family.prefix + part;\n  };\n\n  const api: GuardedStorage = {\n    owner,\n    key(...parts) {\n      const segments = parts.map(normalizeSegment);\n      if (segments.length === 0 || segments.some((segment) => !segment)) {\n        throw new TypeError(`storage key parts must be non-empty: ${JSON.stringify(parts)}`);\n      }\n      return `${prefix}${segments.join('.')}`;\n    },\n    familyKey,\n    isValid,\n    read(key, store) {\n      assertValid(key);\n      const target = resolveStore(key, store);\n      return rawGet(target, key);\n    },\n    write(key, value, store) {\n      assertOwned(key);\n      const target = resolveStore(key, store);\n      return rawSet(target, key, value);\n    },\n    remove(key, store) {\n      assertOwned(key);\n      const target = resolveStore(key, store);\n      rawRemove(target, key);\n    },\n    readJSON<T>(key: string, store?: KeyStore): T | null {\n      const raw = api.read(key, store);\n      if (raw === null) return null;\n      try {\n        return JSON.parse(raw) as T;\n      } catch {\n        return null;\n      }\n    },\n    writeJSON(key, value, store) {\n      return api.write(key, JSON.stringify(value), store);\n    },\n    keys(store = 'local') {\n      return listKeys(store, prefix);\n    },\n    clearAll({ all = false } = {}) {\n      for (const spec of specs) {\n        if (!all && !spec.personal) continue;\n        rawRemove(spec.store, spec.key);\n      }\n      for (const family of families) {\n        if (!all && !family.personal) continue;\n        for (const name of listKeys(family.store, family.prefix)) rawRemove(family.store, name);\n      }\n      if (all) {\n        for (const store of ['local', 'session'] as const) {\n          for (const name of listKeys(store, prefix)) rawRemove(store, name);\n        }\n        for (const name of cookieNames()) if (name.startsWith(prefix)) rawRemove('cookie', name);\n      }\n    },\n    onChange(key, listener, store = 'local') {\n      assertValid(key);\n      if (!hasWindow()) return () => {};\n      const handler = (event: StorageEvent) => {\n        if (event.storageArea !== nativeStorage(store)) return;\n        if (event.key === null || event.key === key) listener(event.key === null ? null : event.newValue);\n      };\n      window.addEventListener('storage', handler);\n      return () => window.removeEventListener('storage', handler);\n    },\n  };\n  return api;\n}\n\n/** The framework's own storage: every `cfg.*` key. */\nexport const cfgStorage: GuardedStorage = createStorage('cfg', {\n  keys: CFG_KEYS,\n  families: CFG_FAMILIES,\n});\n\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/_api/generated/helpers/keys.ts"],"sourcesContent":["// AUTO-GENERATED by django_generator / ts_extras.wrapper\n// Browser-storage key registry: one scheme, guarded access.\n// DO NOT EDIT — re-run `make gen`.\n//\n// Rules for agents and apps: @docs/STORAGE_KEYS.md in @djangocfg/api.\n//\n// Scheme: `<owner>.<area>.<name>` — lower case, dots between levels,\n// `snake_case` inside a level. The framework's owner is `cfg`; an app picks its\n// own with `createStorage('<owner>')`. Third-party keys (a library's own\n// prefix, `NEXT_LOCALE`) are not ours to rename and stay as they are.\n\nexport type KeyStore = 'local' | 'session' | 'cookie';\n\nexport interface KeySpec {\n  /** The canonical key. */\n  readonly key: string;\n  readonly store: KeyStore;\n  /** Removed by `clearAll()` (sign-out). Preferences are kept. */\n  readonly personal: boolean;\n}\n\nexport interface FamilySpec {\n  /** Canonical prefix ending in a dot; the id is appended in normalised form. */\n  readonly prefix: string;\n  readonly store: 'local' | 'session';\n  readonly personal: boolean;\n}\n\nconst k = (\n  key: string,\n  store: KeyStore,\n  personal: boolean,\n): KeySpec => ({ key, store, personal });\n\nconst f = (\n  prefix: string,\n  store: 'local' | 'session',\n  personal: boolean,\n): FamilySpec => ({ prefix, store, personal });\n\n/** Every key the framework writes. No legacy spellings are read: old keys are simply ignored. */\nexport const CFG_KEYS = {\n  accessToken: k('cfg.auth.access_token', 'local', true),\n  refreshToken: k('cfg.auth.refresh_token', 'local', true),\n  apiKey: k('cfg.auth.api_key', 'local', true),\n  email: k('cfg.auth.email', 'local', false),\n  emailTs: k('cfg.auth.email_ts', 'local', false),\n  redirectUrl: k('cfg.auth.redirect_url', 'session', true),\n  redirectUrlTs: k('cfg.auth.redirect_url_ts', 'session', true),\n  oauthState: k('cfg.auth.oauth_state', 'session', true),\n  oauthProvider: k('cfg.auth.oauth_provider', 'session', true),\n  oauthProviders: k('cfg.auth.oauth_providers', 'session', false),\n  profileCache: k('cfg.profile.cache', 'local', true),\n  monitorSessionId: k('cfg.monitor.session_id', 'local', false),\n  monitorSessionCookie: k('cfg.monitor.session_id', 'cookie', false),\n  monitorDebug: k('cfg.monitor.debug', 'local', false),\n  uiTabId: k('cfg.ui.tab_id', 'session', false),\n  uiRouterSerial: k('cfg.ui.router_serial', 'session', false),\n  uiState: k('cfg.ui.state', 'local', false),\n  chatSpeechLanguage: k('cfg.chat.speech_language', 'local', false),\n  chatRecentTools: k('cfg.chat.recent_tools', 'local', false),\n  formsSpeechDebug: k('cfg.forms.speech_debug', 'local', false),\n  formsSpeechPrefs: k('cfg.forms.speech_prefs', 'local', false),\n  agentPlaygroundApiKeyId: k('cfg.agent.playground_api_key_id', 'session', true),\n  agentPlaygroundBearer: k('cfg.agent.playground_bearer', 'session', true),\n  agentEndpointDoc: k('cfg.agent.endpoint_doc', 'session', false),\n} as const satisfies Record<string, KeySpec>;\n\n/** Keys with a caller-supplied id part: one per room, tree, endpoint. */\nexport const CFG_FAMILIES = {\n  chatDraft: f('cfg.chat.draft.', 'session', true),\n  dataTree: f('cfg.data.tree.', 'local', false),\n  agentEndpointDraft: f('cfg.agent.endpoint_draft.', 'local', false),\n} as const satisfies Record<string, FamilySpec>;\n\nconst OWNER_RE = /^[a-z][a-z0-9_]*$/;\n\n/** One segment of a key: lower case, `[a-z0-9_]`, anything else folded to `_`. */\nexport function normalizeSegment(raw: string): string {\n  return raw\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9_]+/g, '_')\n    .replace(/^_+|_+$/g, '');\n}\n\nexport interface StorageOptions {\n  /** Named keys of this owner. */\n  readonly keys?: Readonly<Record<string, KeySpec>>;\n  readonly families?: Readonly<Record<string, FamilySpec>>;\n  /** Cookie lifetime for the `cookie` store. Default 30 days. */\n  readonly cookieMaxAgeSeconds?: number;\n}\n\nexport interface GuardedStorage {\n  readonly owner: string;\n  /** Builds `<owner>.<part>.<part>` from free-form parts; throws if a part is empty. */\n  key(...parts: string[]): string;\n  /** Builds a family member key: the prefix plus the normalised id. */\n  familyKey(family: FamilySpec, id: string): string;\n  /** `^(cfg|<owner>)(\\.[a-z0-9_]+)+$`. */\n  isValid(key: string): boolean;\n  read(key: string, store?: KeyStore): string | null;\n  /** True when the value reached the browser's storage; false means it is held in memory for this page only. */\n  write(key: string, value: string, store?: KeyStore): boolean;\n  /** Removes the key. */\n  remove(key: string, store?: KeyStore): void;\n  readJSON<T>(key: string, store?: KeyStore): T | null;\n  writeJSON(key: string, value: unknown, store?: KeyStore): boolean;\n  /** Keys this owner holds in `store`. */\n  keys(store?: Exclude<KeyStore, 'cookie'>): string[];\n  /** Sign-out: removes the `personal` keys. `{ all: true }` removes everything under this owner. */\n  clearAll(options?: { all?: boolean }): void;\n  /** Cross-tab: calls `listener` with the new value when ANOTHER tab changes `key`. Cookies fire no events. */\n  onChange(key: string, listener: (value: string | null) => void, store?: Exclude<KeyStore, 'cookie'>): () => void;\n}\n\nconst hasWindow = () => typeof window !== 'undefined';\n\nfunction nativeStorage(store: 'local' | 'session'): Storage | null {\n  if (!hasWindow()) return null;\n  try {\n    return store === 'session' ? window.sessionStorage : window.localStorage;\n  } catch {\n    return null;\n  }\n}\n\nfunction cookieNames(): string[] {\n  if (!hasWindow()) return [];\n  try {\n    return document.cookie\n      .split('; ')\n      .map((part) => decodeURIComponent(part.split('=')[0] ?? ''))\n      .filter(Boolean);\n  } catch {\n    return [];\n  }\n}\n\nexport function createStorage(owner: string, options: StorageOptions = {}): GuardedStorage {\n  if (!OWNER_RE.test(owner)) {\n    throw new TypeError(`createStorage: owner \"${owner}\" must match ${OWNER_RE}`);\n  }\n  const prefix = `${owner}.`;\n  const pattern = owner === 'cfg' ? /^cfg(\\.[a-z0-9_]+)+$/ : new RegExp(`^(cfg|${owner})(\\\\.[a-z0-9_]+)+$`);\n  const cookieMaxAge = options.cookieMaxAgeSeconds ?? 60 * 60 * 24 * 30;\n  const specs = Object.values(options.keys ?? {});\n  const families = Object.values(options.families ?? {});\n  const specByKey = new Map<string, KeySpec[]>();\n  for (const spec of specs) specByKey.set(spec.key, [...(specByKey.get(spec.key) ?? []), spec]);\n  // Held in memory when the browser refuses a write (quota, private mode), so the page still works until reload.\n  const memory: Record<KeyStore, Map<string, string>> = {\n    local: new Map(),\n    session: new Map(),\n    cookie: new Map(),\n  };\n\n  const isValid = (key: string) => pattern.test(key);\n  const assertValid = (key: string) => {\n    if (!isValid(key)) throw new TypeError(`storage key \"${key}\" must match ${pattern}`);\n  };\n  const assertOwned = (key: string) => {\n    assertValid(key);\n    if (!key.startsWith(prefix)) throw new TypeError(`storage key \"${key}\" is not owned by \"${owner}\"`);\n  };\n\n  function rawGet(store: KeyStore, key: string): string | null {\n    if (!hasWindow()) return null;\n    if (store === 'cookie') {\n      try {\n        const escaped = encodeURIComponent(key).replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n        const match = document.cookie.match(new RegExp(`(?:^|;\\\\s*)${escaped}=([^;]*)`));\n        if (match?.[1] !== undefined) return decodeURIComponent(match[1]);\n      } catch {\n        /* fall through to memory */\n      }\n      return memory.cookie.get(key) ?? null;\n    }\n    try {\n      const value = nativeStorage(store)?.getItem(key) ?? null;\n      if (value !== null) return value;\n    } catch {\n      /* fall through to memory */\n    }\n    return memory[store].get(key) ?? null;\n  }\n\n  function rawSet(store: KeyStore, key: string, value: string): boolean {\n    if (!hasWindow()) return false;\n    try {\n      if (store === 'cookie') {\n        const secure = window.location.protocol === 'https:' ? '; Secure' : '';\n        document.cookie = `${encodeURIComponent(key)}=${encodeURIComponent(value)}; Path=/; Max-Age=${cookieMaxAge}; SameSite=Lax${secure}`;\n        if (rawGet('cookie', key) === value && !memory.cookie.has(key)) return true;\n        memory.cookie.set(key, value);\n        return false;\n      }\n      const native = nativeStorage(store);\n      if (!native) throw new Error('storage unavailable');\n      native.setItem(key, value);\n      memory[store].delete(key);\n      return true;\n    } catch {\n      memory[store].set(key, value);\n      return false;\n    }\n  }\n\n  function rawRemove(store: KeyStore, key: string): void {\n    memory[store].delete(key);\n    if (!hasWindow()) return;\n    try {\n      if (store === 'cookie') {\n        const secure = window.location.protocol === 'https:' ? '; Secure' : '';\n        document.cookie = `${encodeURIComponent(key)}=; Path=/; Max-Age=0; SameSite=Lax${secure}`;\n      } else {\n        nativeStorage(store)?.removeItem(key);\n      }\n    } catch {\n      /* ignore */\n    }\n  }\n\n  function resolveStore(key: string, store?: KeyStore): KeyStore {\n    return store ?? specByKey.get(key)?.[0]?.store ?? 'local';\n  }\n\n  function listKeys(store: 'local' | 'session', startsWith: string): string[] {\n    const out: string[] = [];\n    try {\n      const native = nativeStorage(store);\n      if (native) {\n        for (let i = 0; i < native.length; i += 1) {\n          const name = native.key(i);\n          if (name?.startsWith(startsWith)) out.push(name);\n        }\n      }\n    } catch {\n      /* ignore */\n    }\n    for (const name of memory[store].keys()) if (name.startsWith(startsWith) && !out.includes(name)) out.push(name);\n    return out;\n  }\n\n  const familyKey = (family: FamilySpec, id: string) => {\n    const part = normalizeSegment(id);\n    if (!part) throw new TypeError('storage family id is empty after normalisation');\n    return family.prefix + part;\n  };\n\n  const api: GuardedStorage = {\n    owner,\n    key(...parts) {\n      const segments = parts.map(normalizeSegment);\n      if (segments.length === 0 || segments.some((segment) => !segment)) {\n        throw new TypeError(`storage key parts must be non-empty: ${JSON.stringify(parts)}`);\n      }\n      return `${prefix}${segments.join('.')}`;\n    },\n    familyKey,\n    isValid,\n    read(key, store) {\n      assertValid(key);\n      const target = resolveStore(key, store);\n      return rawGet(target, key);\n    },\n    write(key, value, store) {\n      assertOwned(key);\n      const target = resolveStore(key, store);\n      return rawSet(target, key, value);\n    },\n    remove(key, store) {\n      assertOwned(key);\n      const target = resolveStore(key, store);\n      rawRemove(target, key);\n    },\n    readJSON<T>(key: string, store?: KeyStore): T | null {\n      const raw = api.read(key, store);\n      if (raw === null) return null;\n      try {\n        return JSON.parse(raw) as T;\n      } catch {\n        return null;\n      }\n    },\n    writeJSON(key, value, store) {\n      return api.write(key, JSON.stringify(value), store);\n    },\n    keys(store = 'local') {\n      return listKeys(store, prefix);\n    },\n    clearAll({ all = false } = {}) {\n      for (const spec of specs) {\n        if (!all && !spec.personal) continue;\n        rawRemove(spec.store, spec.key);\n      }\n      for (const family of families) {\n        if (!all && !family.personal) continue;\n        for (const name of listKeys(family.store, family.prefix)) rawRemove(family.store, name);\n      }\n      if (all) {\n        for (const store of ['local', 'session'] as const) {\n          for (const name of listKeys(store, prefix)) rawRemove(store, name);\n        }\n        for (const name of cookieNames()) if (name.startsWith(prefix)) rawRemove('cookie', name);\n      }\n    },\n    onChange(key, listener, store = 'local') {\n      assertValid(key);\n      if (!hasWindow()) return () => {};\n      const handler = (event: StorageEvent) => {\n        if (event.storageArea !== nativeStorage(store)) return;\n        if (event.key === null || event.key === key) listener(event.key === null ? null : event.newValue);\n      };\n      window.addEventListener('storage', handler);\n      return () => window.removeEventListener('storage', handler);\n    },\n  };\n  return api;\n}\n\n/** The framework's own storage: every `cfg.*` key. */\nexport const cfgStorage: GuardedStorage = createStorage('cfg', {\n  keys: CFG_KEYS,\n  families: CFG_FAMILIES,\n});\n\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/api",
-  "version": "2.1.599",
+  "version": "2.1.601",
   "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.599",
+    "@djangocfg/typescript-config": "^2.1.601",
     "@testing-library/react": "^16.3.2",
     "@types/node": "^25.9.5",
     "@types/react": "19.2.15",

package/src/__tests__/noStorageLiterals.test.ts

@@ -5,7 +5,7 @@ import { describe, expect, it } from 'vitest';
 // Storage keys are defined once, in the registry. A literal anywhere else is a bug.
 const FORBIDDEN = [
   'user_profile_cache', 'auth_email', 'auth_redirect_url', 'fm_session_id', 'oauth_state',
-  'oauth_provider', 'cfg.access_token', 'cfg.refresh_token', 'cfg.api_key',
+  'oauth_provider', 'oauth_providers', 'cfg.access_token', 'cfg.refresh_token', 'cfg.api_key',
 ];
 
 function walk(dir: string, out: string[] = []): string[] {

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

@@ -9,6 +9,8 @@ export { useCfgAccountsOauthConnectionsList } from "./useCfgAccountsOauthConnect
 export { useCfgAccountsOauthDisconnectCreate } from "./useCfgAccountsOauthDisconnectCreate";
 export { useCfgAccountsOauthGithubAuthorizeCreate } from "./useCfgAccountsOauthGithubAuthorizeCreate";
 export { useCfgAccountsOauthGithubCallbackCreate } from "./useCfgAccountsOauthGithubCallbackCreate";
+export { useCfgAccountsOauthGoogleAuthorizeCreate } from "./useCfgAccountsOauthGoogleAuthorizeCreate";
+export { useCfgAccountsOauthGoogleCallbackCreate } from "./useCfgAccountsOauthGoogleCallbackCreate";
 export { useCfgAccountsOauthProvidersRetrieve } from "./useCfgAccountsOauthProvidersRetrieve";
 export { useCfgAccountsOtpConsentPolicyRetrieve } from "./useCfgAccountsOtpConsentPolicyRetrieve";
 export { useCfgAccountsOtpRequestCreate } from "./useCfgAccountsOtpRequestCreate";

package/src/_api/generated/_cfg_accounts/hooks/useCfgAccountsOauthGoogleAuthorizeCreate.ts

@@ -0,0 +1,68 @@
+'use client';
+
+// AUTO-GENERATED by openapi_processor / ts.hooks
+// Start Google OAuth
+// DO NOT EDIT — re-run `make gen`.
+
+import useSWRMutation from "swr/mutation";
+import type { SWRMutationConfiguration } from "swr/mutation";
+import { CfgAccountsOauth } from "../../sdk.gen";
+import type { CfgAccountsOauthGoogleAuthorizeCreateData, CfgAccountsOauthGoogleAuthorizeCreateResponses } from "../../types.gen";
+
+
+type Args = Omit<CfgAccountsOauthGoogleAuthorizeCreateData, "url">;
+type Result = CfgAccountsOauthGoogleAuthorizeCreateResponses[keyof CfgAccountsOauthGoogleAuthorizeCreateResponses];
+
+export function useCfgAccountsOauthGoogleAuthorizeCreate(
+  config?: SWRMutationConfiguration<Result, Error, readonly ["cfg_accounts_oauth_google_authorize_create"], Args>,
+) {
+  return useSWRMutation<Result, Error, readonly ["cfg_accounts_oauth_google_authorize_create"], Args>(
+    ["cfg_accounts_oauth_google_authorize_create"] as const,
+    async (_key, { arg }: { arg: Args }) => {
+      const res = await CfgAccountsOauth.cfgAccountsOauthGoogleAuthorizeCreate({ ...arg, throwOnError: true } as never);
+      const data = res.data as Result;
+      void import("../schemas/OAuthAuthorizeResponse")
+        .then(({ OAuthAuthorizeResponseSchema }) => {
+          const parsed = OAuthAuthorizeResponseSchema.safeParse(data);
+          if (parsed.success) return;
+          // Log first so the failure is always visible, even if the
+          // event handler swallows it.
+          console.warn(
+            "[zod] response did not match schema",
+            {
+              operation: "cfg_accounts_oauth_google_authorize_create",
+              method: "POST",
+              path: "/cfg/accounts/oauth/google/authorize/",
+              issues: parsed.error.issues,
+              data,
+            },
+          );
+          if (typeof window !== "undefined") {
+            try {
+              window.dispatchEvent(
+                new CustomEvent("zod-validation-error", {
+                  detail: {
+                    operation: "cfg_accounts_oauth_google_authorize_create",
+                    method: "POST",
+                    path: "/cfg/accounts/oauth/google/authorize/",
+                    issues: parsed.error.issues,
+                    data,
+                    timestamp: new Date(),
+                  },
+                  bubbles: true,
+                  cancelable: false,
+                }),
+              );
+            } catch {
+              // Event dispatch is best-effort.
+            }
+          }
+        })
+        .catch(() => {
+          // A schema chunk that fails to load is not the caller's problem.
+        });
+      return data;
+    },
+    config,
+  );
+}

package/src/_api/generated/_cfg_accounts/hooks/useCfgAccountsOauthGoogleCallbackCreate.ts

@@ -0,0 +1,68 @@
+'use client';
+
+// AUTO-GENERATED by openapi_processor / ts.hooks
+// Complete Google OAuth
+// DO NOT EDIT — re-run `make gen`.
+
+import useSWRMutation from "swr/mutation";
+import type { SWRMutationConfiguration } from "swr/mutation";
+import { CfgAccountsOauth } from "../../sdk.gen";
+import type { CfgAccountsOauthGoogleCallbackCreateData, CfgAccountsOauthGoogleCallbackCreateResponses } from "../../types.gen";
+
+
+type Args = Omit<CfgAccountsOauthGoogleCallbackCreateData, "url">;
+type Result = CfgAccountsOauthGoogleCallbackCreateResponses[keyof CfgAccountsOauthGoogleCallbackCreateResponses];
+
+export function useCfgAccountsOauthGoogleCallbackCreate(
+  config?: SWRMutationConfiguration<Result, Error, readonly ["cfg_accounts_oauth_google_callback_create"], Args>,
+) {
+  return useSWRMutation<Result, Error, readonly ["cfg_accounts_oauth_google_callback_create"], Args>(
+    ["cfg_accounts_oauth_google_callback_create"] as const,
+    async (_key, { arg }: { arg: Args }) => {
+      const res = await CfgAccountsOauth.cfgAccountsOauthGoogleCallbackCreate({ ...arg, throwOnError: true } as never);
+      const data = res.data as Result;
+      void import("../schemas/OAuthTokenResponse")
+        .then(({ OAuthTokenResponseSchema }) => {
+          const parsed = OAuthTokenResponseSchema.safeParse(data);
+          if (parsed.success) return;
+          // Log first so the failure is always visible, even if the
+          // event handler swallows it.
+          console.warn(
+            "[zod] response did not match schema",
+            {
+              operation: "cfg_accounts_oauth_google_callback_create",
+              method: "POST",
+              path: "/cfg/accounts/oauth/google/callback/",
+              issues: parsed.error.issues,
+              data,
+            },
+          );
+          if (typeof window !== "undefined") {
+            try {
+              window.dispatchEvent(
+                new CustomEvent("zod-validation-error", {
+                  detail: {
+                    operation: "cfg_accounts_oauth_google_callback_create",
+                    method: "POST",
+                    path: "/cfg/accounts/oauth/google/callback/",
+                    issues: parsed.error.issues,
+                    data,
+                    timestamp: new Date(),
+                  },
+                  bubbles: true,
+                  cancelable: false,
+                }),
+              );
+            } catch {
+              // Event dispatch is best-effort.
+            }
+          }
+        })
+        .catch(() => {
+          // A schema chunk that fails to load is not the caller's problem.
+        });
+      return data;
+    },
+    config,
+  );
+}