@djangocfg/api 2.1.582 → 2.1.583

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/README.md +18 -0
  2. package/dist/auth.cjs +272 -80
  3. package/dist/auth.cjs.map +1 -1
  4. package/dist/auth.mjs +272 -80
  5. package/dist/auth.mjs.map +1 -1
  6. package/dist/clients.cjs +243 -54
  7. package/dist/clients.cjs.map +1 -1
  8. package/dist/clients.mjs +243 -54
  9. package/dist/clients.mjs.map +1 -1
  10. package/dist/hooks.cjs +243 -54
  11. package/dist/hooks.cjs.map +1 -1
  12. package/dist/hooks.mjs +243 -54
  13. package/dist/hooks.mjs.map +1 -1
  14. package/dist/index.cjs +248 -54
  15. package/dist/index.cjs.map +1 -1
  16. package/dist/index.d.cts +85 -1
  17. package/dist/index.d.ts +85 -1
  18. package/dist/index.mjs +248 -54
  19. package/dist/index.mjs.map +1 -1
  20. package/dist/storage.cjs +269 -0
  21. package/dist/storage.cjs.map +1 -0
  22. package/dist/storage.d.cts +85 -0
  23. package/dist/storage.d.ts +85 -0
  24. package/dist/storage.mjs +248 -0
  25. package/dist/storage.mjs.map +1 -0
  26. package/package.json +8 -2
  27. package/src/__tests__/noStorageLiterals.test.ts +27 -0
  28. package/src/__tests__/storage.test.ts +134 -0
  29. package/src/__tests__/storageSsr.test.ts +14 -0
  30. package/src/_api/generated/helpers/auth.ts +27 -64
  31. package/src/_api/generated/helpers/index.ts +12 -0
  32. package/src/_api/generated/helpers/keys.ts +328 -0
  33. package/src/auth/__tests__/authRedirect.test.ts +1 -1
  34. package/src/auth/__tests__/profileCache.test.ts +1 -1
  35. package/src/auth/context/AuthContext.tsx +2 -1
  36. package/src/auth/hooks/useAuthRedirect.ts +3 -2
  37. package/src/auth/hooks/useGithubAuth.ts +13 -8
  38. package/src/auth/hooks/useLocalStorage.ts +7 -7
  39. package/src/auth/hooks/useProfileCache.ts +2 -1
  40. package/src/auth/hooks/useSessionStorage.ts +7 -7
  41. package/src/storage.ts +21 -0
package/dist/hooks.cjs CHANGED
@@ -999,77 +999,264 @@ var APIError = class extends Error {
999
999
  }
1000
1000
  };
1001
1001
 
1002
- // src/_api/generated/helpers/auth.ts
1003
- var ACCESS_KEY = "cfg.access_token";
1004
- var REFRESH_KEY = "cfg.refresh_token";
1005
- var API_KEY_KEY = "cfg.api_key";
1006
- var isBrowser = typeof window !== "undefined";
1007
- var localStorageBackend = {
1008
- get(key) {
1009
- if (!isBrowser) return null;
1010
- try {
1011
- return window.localStorage.getItem(key);
1012
- } catch {
1013
- return null;
1002
+ // src/_api/generated/helpers/keys.ts
1003
+ var k = /* @__PURE__ */ __name((key, store, personal) => ({ key, store, personal }), "k");
1004
+ var f = /* @__PURE__ */ __name((prefix, store, personal) => ({ prefix, store, personal }), "f");
1005
+ var CFG_KEYS = {
1006
+ accessToken: k("cfg.auth.access_token", "local", true),
1007
+ refreshToken: k("cfg.auth.refresh_token", "local", true),
1008
+ apiKey: k("cfg.auth.api_key", "local", true),
1009
+ email: k("cfg.auth.email", "local", false),
1010
+ emailTs: k("cfg.auth.email_ts", "local", false),
1011
+ redirectUrl: k("cfg.auth.redirect_url", "session", true),
1012
+ redirectUrlTs: k("cfg.auth.redirect_url_ts", "session", true),
1013
+ oauthState: k("cfg.auth.oauth_state", "session", true),
1014
+ oauthProvider: k("cfg.auth.oauth_provider", "session", true),
1015
+ oauthRememberMe: k("cfg.auth.oauth_remember_me", "session", true),
1016
+ profileCache: k("cfg.profile.cache", "local", true),
1017
+ monitorSessionId: k("cfg.monitor.session_id", "local", false),
1018
+ monitorSessionCookie: k("cfg.monitor.session_id", "cookie", false),
1019
+ monitorDebug: k("cfg.monitor.debug", "local", false),
1020
+ uiTabId: k("cfg.ui.tab_id", "session", false),
1021
+ uiRouterSerial: k("cfg.ui.router_serial", "session", false),
1022
+ uiState: k("cfg.ui.state", "local", false),
1023
+ chatSpeechLanguage: k("cfg.chat.speech_language", "local", false),
1024
+ chatRecentTools: k("cfg.chat.recent_tools", "local", false),
1025
+ formsSpeechDebug: k("cfg.forms.speech_debug", "local", false),
1026
+ formsSpeechPrefs: k("cfg.forms.speech_prefs", "local", false),
1027
+ agentPlaygroundApiKeyId: k("cfg.agent.playground_api_key_id", "session", true),
1028
+ agentPlaygroundBearer: k("cfg.agent.playground_bearer", "session", true),
1029
+ agentEndpointDoc: k("cfg.agent.endpoint_doc", "session", false)
1030
+ };
1031
+ var CFG_FAMILIES = {
1032
+ chatDraft: f("cfg.chat.draft.", "session", true),
1033
+ dataTree: f("cfg.data.tree.", "local", false),
1034
+ agentEndpointDraft: f("cfg.agent.endpoint_draft.", "local", false)
1035
+ };
1036
+ var OWNER_RE = /^[a-z][a-z0-9_]*$/;
1037
+ function normalizeSegment(raw) {
1038
+ return raw.trim().toLowerCase().replace(/[^a-z0-9_]+/g, "_").replace(/^_+|_+$/g, "");
1039
+ }
1040
+ __name(normalizeSegment, "normalizeSegment");
1041
+ var hasWindow = /* @__PURE__ */ __name(() => typeof window !== "undefined", "hasWindow");
1042
+ function nativeStorage(store) {
1043
+ if (!hasWindow()) return null;
1044
+ try {
1045
+ return store === "session" ? window.sessionStorage : window.localStorage;
1046
+ } catch {
1047
+ return null;
1048
+ }
1049
+ }
1050
+ __name(nativeStorage, "nativeStorage");
1051
+ function cookieNames() {
1052
+ if (!hasWindow()) return [];
1053
+ try {
1054
+ return document.cookie.split("; ").map((part) => decodeURIComponent(part.split("=")[0] ?? "")).filter(Boolean);
1055
+ } catch {
1056
+ return [];
1057
+ }
1058
+ }
1059
+ __name(cookieNames, "cookieNames");
1060
+ function createStorage(owner, options = {}) {
1061
+ if (!OWNER_RE.test(owner)) {
1062
+ throw new TypeError(`createStorage: owner "${owner}" must match ${OWNER_RE}`);
1063
+ }
1064
+ const prefix = `${owner}.`;
1065
+ const pattern = owner === "cfg" ? /^cfg(\.[a-z0-9_]+)+$/ : new RegExp(`^(cfg|${owner})(\\.[a-z0-9_]+)+$`);
1066
+ const cookieMaxAge = options.cookieMaxAgeSeconds ?? 60 * 60 * 24 * 30;
1067
+ const specs = Object.values(options.keys ?? {});
1068
+ const families = Object.values(options.families ?? {});
1069
+ const specByKey = /* @__PURE__ */ new Map();
1070
+ for (const spec of specs) specByKey.set(spec.key, [...specByKey.get(spec.key) ?? [], spec]);
1071
+ const memory = {
1072
+ local: /* @__PURE__ */ new Map(),
1073
+ session: /* @__PURE__ */ new Map(),
1074
+ cookie: /* @__PURE__ */ new Map()
1075
+ };
1076
+ const isValid = /* @__PURE__ */ __name((key) => pattern.test(key), "isValid");
1077
+ const assertValid = /* @__PURE__ */ __name((key) => {
1078
+ if (!isValid(key)) throw new TypeError(`storage key "${key}" must match ${pattern}`);
1079
+ }, "assertValid");
1080
+ const assertOwned = /* @__PURE__ */ __name((key) => {
1081
+ assertValid(key);
1082
+ if (!key.startsWith(prefix)) throw new TypeError(`storage key "${key}" is not owned by "${owner}"`);
1083
+ }, "assertOwned");
1084
+ function rawGet(store, key) {
1085
+ if (!hasWindow()) return null;
1086
+ if (store === "cookie") {
1087
+ try {
1088
+ const escaped = encodeURIComponent(key).replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
1089
+ const match = document.cookie.match(new RegExp(`(?:^|;\\s*)${escaped}=([^;]*)`));
1090
+ if (match?.[1] !== void 0) return decodeURIComponent(match[1]);
1091
+ } catch {
1092
+ }
1093
+ return memory.cookie.get(key) ?? null;
1014
1094
  }
1015
- },
1016
- set(key, value) {
1017
- if (!isBrowser) return;
1018
1095
  try {
1019
- if (value === null) window.localStorage.removeItem(key);
1020
- else window.localStorage.setItem(key, value);
1096
+ const value = nativeStorage(store)?.getItem(key) ?? null;
1097
+ if (value !== null) return value;
1021
1098
  } catch {
1022
1099
  }
1100
+ return memory[store].get(key) ?? null;
1023
1101
  }
1024
- };
1025
- var sessionStorageBackend = {
1026
- get(key) {
1027
- if (!isBrowser) return null;
1102
+ __name(rawGet, "rawGet");
1103
+ function rawSet(store, key, value) {
1104
+ if (!hasWindow()) return false;
1028
1105
  try {
1029
- return window.sessionStorage.getItem(key);
1106
+ if (store === "cookie") {
1107
+ const secure = window.location.protocol === "https:" ? "; Secure" : "";
1108
+ document.cookie = `${encodeURIComponent(key)}=${encodeURIComponent(value)}; Path=/; Max-Age=${cookieMaxAge}; SameSite=Lax${secure}`;
1109
+ if (rawGet("cookie", key) === value && !memory.cookie.has(key)) return true;
1110
+ memory.cookie.set(key, value);
1111
+ return false;
1112
+ }
1113
+ const native = nativeStorage(store);
1114
+ if (!native) throw new Error("storage unavailable");
1115
+ native.setItem(key, value);
1116
+ memory[store].delete(key);
1117
+ return true;
1030
1118
  } catch {
1031
- return null;
1119
+ memory[store].set(key, value);
1120
+ return false;
1032
1121
  }
1033
- },
1034
- set(key, value) {
1035
- if (!isBrowser) return;
1122
+ }
1123
+ __name(rawSet, "rawSet");
1124
+ function rawRemove(store, key) {
1125
+ memory[store].delete(key);
1126
+ if (!hasWindow()) return;
1036
1127
  try {
1037
- if (value === null) window.sessionStorage.removeItem(key);
1038
- else window.sessionStorage.setItem(key, value);
1128
+ if (store === "cookie") {
1129
+ const secure = window.location.protocol === "https:" ? "; Secure" : "";
1130
+ document.cookie = `${encodeURIComponent(key)}=; Path=/; Max-Age=0; SameSite=Lax${secure}`;
1131
+ } else {
1132
+ nativeStorage(store)?.removeItem(key);
1133
+ }
1039
1134
  } catch {
1040
1135
  }
1041
1136
  }
1042
- };
1043
- var COOKIE_MAX_AGE = 60 * 60 * 24 * 30;
1044
- var cookieBackend = {
1045
- get(key) {
1046
- if (!isBrowser) return null;
1137
+ __name(rawRemove, "rawRemove");
1138
+ function resolveStore(key, store) {
1139
+ return store ?? specByKey.get(key)?.[0]?.store ?? "local";
1140
+ }
1141
+ __name(resolveStore, "resolveStore");
1142
+ function listKeys(store, startsWith) {
1143
+ const out = [];
1047
1144
  try {
1048
- const re = new RegExp(`(?:^|;\\s*)${encodeURIComponent(key)}=([^;]*)`);
1049
- const m = document.cookie.match(re);
1050
- const value = m?.[1];
1051
- return value === void 0 ? null : decodeURIComponent(value);
1145
+ const native = nativeStorage(store);
1146
+ if (native) {
1147
+ for (let i = 0; i < native.length; i += 1) {
1148
+ const name = native.key(i);
1149
+ if (name?.startsWith(startsWith)) out.push(name);
1150
+ }
1151
+ }
1052
1152
  } catch {
1053
- return null;
1054
1153
  }
1055
- },
1056
- set(key, value) {
1057
- if (!isBrowser) return;
1058
- try {
1059
- const k = encodeURIComponent(key);
1060
- const secure = window.location.protocol === "https:" ? "; Secure" : "";
1061
- if (value === null) {
1062
- document.cookie = `${k}=; Path=/; Max-Age=0; SameSite=Lax${secure}`;
1063
- } else {
1064
- const v = encodeURIComponent(value);
1065
- document.cookie = `${k}=${v}; Path=/; Max-Age=${COOKIE_MAX_AGE}; SameSite=Lax${secure}`;
1154
+ for (const name of memory[store].keys()) if (name.startsWith(startsWith) && !out.includes(name)) out.push(name);
1155
+ return out;
1156
+ }
1157
+ __name(listKeys, "listKeys");
1158
+ const familyKey = /* @__PURE__ */ __name((family, id) => {
1159
+ const part = normalizeSegment(id);
1160
+ if (!part) throw new TypeError("storage family id is empty after normalisation");
1161
+ return family.prefix + part;
1162
+ }, "familyKey");
1163
+ const api = {
1164
+ owner,
1165
+ key(...parts) {
1166
+ const segments = parts.map(normalizeSegment);
1167
+ if (segments.length === 0 || segments.some((segment) => !segment)) {
1168
+ throw new TypeError(`storage key parts must be non-empty: ${JSON.stringify(parts)}`);
1066
1169
  }
1067
- } catch {
1170
+ return `${prefix}${segments.join(".")}`;
1171
+ },
1172
+ familyKey,
1173
+ isValid,
1174
+ read(key, store) {
1175
+ assertValid(key);
1176
+ const target = resolveStore(key, store);
1177
+ return rawGet(target, key);
1178
+ },
1179
+ write(key, value, store) {
1180
+ assertOwned(key);
1181
+ const target = resolveStore(key, store);
1182
+ return rawSet(target, key, value);
1183
+ },
1184
+ remove(key, store) {
1185
+ assertOwned(key);
1186
+ const target = resolveStore(key, store);
1187
+ rawRemove(target, key);
1188
+ },
1189
+ readJSON(key, store) {
1190
+ const raw = api.read(key, store);
1191
+ if (raw === null) return null;
1192
+ try {
1193
+ return JSON.parse(raw);
1194
+ } catch {
1195
+ return null;
1196
+ }
1197
+ },
1198
+ writeJSON(key, value, store) {
1199
+ return api.write(key, JSON.stringify(value), store);
1200
+ },
1201
+ keys(store = "local") {
1202
+ return listKeys(store, prefix);
1203
+ },
1204
+ clearAll({ all = false } = {}) {
1205
+ for (const spec of specs) {
1206
+ if (!all && !spec.personal) continue;
1207
+ rawRemove(spec.store, spec.key);
1208
+ }
1209
+ for (const family of families) {
1210
+ if (!all && !family.personal) continue;
1211
+ for (const name of listKeys(family.store, family.prefix)) rawRemove(family.store, name);
1212
+ }
1213
+ if (all) {
1214
+ for (const store of ["local", "session"]) {
1215
+ for (const name of listKeys(store, prefix)) rawRemove(store, name);
1216
+ }
1217
+ for (const name of cookieNames()) if (name.startsWith(prefix)) rawRemove("cookie", name);
1218
+ }
1219
+ },
1220
+ onChange(key, listener, store = "local") {
1221
+ assertValid(key);
1222
+ if (!hasWindow()) return () => {
1223
+ };
1224
+ const handler = /* @__PURE__ */ __name((event) => {
1225
+ if (event.storageArea !== nativeStorage(store)) return;
1226
+ if (event.key === null || event.key === key) listener(event.key === null ? null : event.newValue);
1227
+ }, "handler");
1228
+ window.addEventListener("storage", handler);
1229
+ return () => window.removeEventListener("storage", handler);
1068
1230
  }
1069
- }
1231
+ };
1232
+ return api;
1233
+ }
1234
+ __name(createStorage, "createStorage");
1235
+ var cfgStorage = createStorage("cfg", {
1236
+ keys: CFG_KEYS,
1237
+ families: CFG_FAMILIES
1238
+ });
1239
+
1240
+ // src/_api/generated/helpers/auth.ts
1241
+ var ACCESS_KEY = "cfg.auth.access_token";
1242
+ var REFRESH_KEY = "cfg.auth.refresh_token";
1243
+ var API_KEY_KEY = "cfg.auth.api_key";
1244
+ var storage = true ? cfgStorage : createStorage2("cfg");
1245
+ var isBrowser = typeof window !== "undefined";
1246
+ var STORE_OF = {
1247
+ localStorage: "local",
1248
+ sessionStorage: "session",
1249
+ cookie: "cookie"
1070
1250
  };
1071
1251
  function backendFor(mode) {
1072
- return mode === "cookie" ? cookieBackend : mode === "sessionStorage" ? sessionStorageBackend : localStorageBackend;
1252
+ const store = STORE_OF[mode];
1253
+ return {
1254
+ get: /* @__PURE__ */ __name((key) => storage.read(key, store), "get"),
1255
+ set(key, value) {
1256
+ if (value === null) storage.remove(key, store);
1257
+ else storage.write(key, value, store);
1258
+ }
1259
+ };
1073
1260
  }
1074
1261
  __name(backendFor, "backendFor");
1075
1262
  var _storageMode = "localStorage";
@@ -1258,10 +1445,12 @@ var auth = {
1258
1445
  notifySessionChanged();
1259
1446
  },
1260
1447
  clearTokens() {
1261
- for (const backend of [localStorageBackend, sessionStorageBackend, cookieBackend]) {
1448
+ for (const mode of ["localStorage", "sessionStorage", "cookie"]) {
1449
+ const backend = backendFor(mode);
1262
1450
  backend.set(ACCESS_KEY, null);
1263
1451
  backend.set(REFRESH_KEY, null);
1264
1452
  }
1453
+ storage.clearAll();
1265
1454
  notifySessionChanged();
1266
1455
  },
1267
1456
  /** Session-aware: token PRESENT and not past its `exp` (or a live refresh
@@ -1453,7 +1642,7 @@ function dpopEnabled() {
1453
1642
  }
1454
1643
  }
1455
1644
  __name(dpopEnabled, "dpopEnabled");
1456
- var _DPOP_DB = "cfg-auth";
1645
+ var _DPOP_DB = "cfg.auth.dpop";
1457
1646
  var _DPOP_STORE = "keys";
1458
1647
  var _DPOP_KEY_ID = "dpop-ec-p256";
1459
1648
  function _idbOpen() {