@lowdefy/client 6.0.0 → 7.0.0

package/dist/storage/clearUserStorageOnOwnerChange.js

@@ -0,0 +1,41 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import clearUserStorage from './clearUserStorage.js';
+import listUserStorageKeys from './listUserStorageKeys.js';
+// The person signed in (or nobody) may not be the one who left data on this browser: another
+// person signed in on it, or a session ended without Logout running. Their keys go before any
+// block reads storage.
+function clearUserStorageOnOwnerChange({ basePath, slug, userId, window }) {
+    let entries;
+    try {
+        entries = listUserStorageKeys({
+            basePath,
+            slug,
+            storage: window.localStorage
+        });
+    } catch  {
+        // Storage the browser blocks holds nothing to clear.
+        return;
+    }
+    if (entries.some((entry)=>entry.userId !== userId)) {
+        clearUserStorage({
+            basePath,
+            keepUserId: userId,
+            slug,
+            window
+        });
+    }
+}
+export default clearUserStorageOnOwnerChange;

package/dist/storage/createStorage.js

@@ -0,0 +1,48 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { appStorageKey } from '@lowdefy/helpers';
+import clearUserStorage from './clearUserStorage.js';
+import clearUserStorageOnOwnerChange from './clearUserStorageOnOwnerChange.js';
+import userStorageKey from './userStorageKey.js';
+// Storage keys for this app, reached by blocks and actions through their methods. getUserId is
+// read on every call, so a user key always names the person signed in now.
+function createStorage({ basePath, getUserId, slug, window }) {
+    return {
+        appKey: (name)=>appStorageKey({
+                basePath,
+                name,
+                slug
+            }),
+        clearUserStorage: ({ keepUserId })=>clearUserStorage({
+                basePath,
+                keepUserId,
+                slug,
+                window
+            }),
+        clearUserStorageOnOwnerChange: ()=>clearUserStorageOnOwnerChange({
+                basePath,
+                slug,
+                userId: getUserId(),
+                window
+            }),
+        userKey: (name)=>userStorageKey({
+                basePath,
+                name,
+                slug,
+                userId: getUserId()
+            })
+    };
+}
+export default createStorage;

package/dist/storage/listUserStorageKeys.js

@@ -0,0 +1,36 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import userStoragePrefix from './userStoragePrefix.js';
+// Every user key of this app in storage, with its owner's user id (null for an anonymous
+// visitor). Keys are read before any is removed, since removing shifts storage indexes.
+function listUserStorageKeys({ basePath, slug, storage }) {
+    const prefix = userStoragePrefix({
+        basePath,
+        slug
+    });
+    const entries = [];
+    for(let index = 0; index < storage.length; index += 1){
+        const key = storage.key(index);
+        if (key.startsWith(prefix)) {
+            const owner = key.slice(prefix.length, key.indexOf(':', prefix.length));
+            entries.push({
+                key,
+                userId: owner === '' ? null : decodeURIComponent(owner)
+            });
+        }
+    }
+    return entries;
+}
+export default listUserStorageKeys;

package/dist/storage/readStorageItem.js

@@ -0,0 +1,31 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { type } from '@lowdefy/helpers';
+// Reads key, moving a value left under legacyKey (written before keys were kept per app) to it
+// the first time. Returns null when neither holds a value or the browser blocks storage.
+function readStorageItem({ key, legacyKey, storage }) {
+    try {
+        const value = storage.getItem(key);
+        if (!type.isNone(value)) return value;
+        const legacyValue = storage.getItem(legacyKey);
+        if (type.isNone(legacyValue)) return null;
+        storage.setItem(key, legacyValue);
+        storage.removeItem(legacyKey);
+        return legacyValue;
+    } catch  {
+        return null;
+    }
+}
+export default readStorageItem;

package/dist/storage/userStorageKey.js

@@ -0,0 +1,24 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import userStoragePrefix from './userStoragePrefix.js';
+// The user id is encoded so the owner always ends at the next ":", whatever the id holds. An
+// anonymous visitor owns the empty id.
+function userStorageKey({ basePath, name, slug, userId }) {
+    return `${userStoragePrefix({
+        basePath,
+        slug
+    })}${encodeURIComponent(userId ?? '')}:${name}`;
+}
+export default userStorageKey;

package/dist/storage/userStoragePrefix.js

@@ -0,0 +1,25 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { appStorageKey } from '@lowdefy/helpers';
+// A person's data sits under one name in the app's namespace, then the owner's user id. Keys set
+// with SetLocalStorage can not start with "lowdefy_", so no app key reads as a user key.
+function userStoragePrefix({ basePath, slug }) {
+    return appStorageKey({
+        basePath,
+        name: 'lowdefy_user:',
+        slug
+    });
+}
+export default userStoragePrefix;

package/dist/useDarkMode.js

@@ -14,6 +14,7 @@
   limitations under the License.
 */ import { useCallback, useEffect, useMemo, useState } from 'react';
 import { theme as antdTheme } from 'antd';
+import readStorageItem from './storage/readStorageItem.js';
 const algorithmMap = {
     default: antdTheme.defaultAlgorithm,
     dark: antdTheme.darkAlgorithm,
@@ -67,11 +68,16 @@ function mergeComponents(shared, mode) {
     });
     return merged;
 }
-function useDarkMode({ antd, configDarkMode }) {
+// storageKey is the app key the preference is kept under (see @lowdefy/helpers appStorageKey).
+function useDarkMode({ antd, configDarkMode, storageKey }) {
     const baseAlgorithm = antd?.algorithm;
     const cleanAlgorithm = stripDarkFromAlgorithm(baseAlgorithm);
     const [userPreference, setUserPreference] = useState(()=>{
-        return window.localStorage?.getItem('lowdefy_darkMode') ?? 'system';
+        return readStorageItem({
+            key: storageKey,
+            legacyKey: 'lowdefy_darkMode',
+            storage: window.localStorage
+        }) ?? 'system';
     });
     const [systemIsDark, setSystemIsDark] = useState(()=>{
         return window.matchMedia?.('(prefers-color-scheme: dark)')?.matches ?? false;
@@ -85,10 +91,17 @@ function useDarkMode({ antd, configDarkMode }) {
         return ()=>mql.removeEventListener('change', handler);
     }, []);
     const setPreference = useCallback((newPref)=>{
-        window.localStorage?.setItem('lowdefy_darkMode', newPref);
+        window.localStorage?.setItem(storageKey, newPref);
+        // Set now, not on the next render: SetDarkMode updates the engine straight after, and
+        // _media: darkModePreference reads it then.
+        window.__lowdefy_darkModePreference = newPref;
         setUserPreference(newPref);
-    }, []);
+    }, [
+        storageKey
+    ]);
     window.__lowdefy_setDarkMode = setPreference;
+    // SetDarkMode, _media and the header toggles read the preference here, not from storage.
+    window.__lowdefy_darkModePreference = userPreference;
     const isDark = resolveIsDark({
         configDarkMode,
         userPreference,

package/dist/useLocale.js

@@ -14,6 +14,10 @@
   limitations under the License.
 */ import { useCallback, useEffect, useMemo, useState } from 'react';
 import dayjs from 'dayjs';
+import antdEnUS from 'antd/locale/en_US.js';
+import readStorageItem from './storage/readStorageItem.js';
+// antd shows its en_US strings until an app locale loads, and with none configured.
+const defaultAntdLocale = antdEnUS.default ?? antdEnUS;
 function pickBest(candidates, supported) {
     for (const candidate of candidates ?? []){
         if (supported.includes(candidate)) return candidate;
@@ -40,12 +44,17 @@ async function loadAntdXLocale({ active, antdXLocaleLoaders }) {
     const mod = await antdXLocaleLoaders[active]();
     return mod?.default ?? mod;
 }
-function useLocale({ i18n, antdLocaleLoaders, antdXLocaleLoaders, dayjsLocaleMap }) {
+// storageKey is the app key the preference is kept under (see @lowdefy/helpers appStorageKey).
+function useLocale({ i18n, antdLocaleLoaders, antdXLocaleLoaders, dayjsLocaleMap, storageKey }) {
     const supportedCodes = useMemo(()=>(i18n?.locales ?? []).map((l)=>l.code), [
         i18n?.locales
     ]);
     const [userPreference, setUserPreference] = useState(()=>{
-        return window.localStorage?.getItem('lowdefy_locale') ?? 'auto';
+        return readStorageItem({
+            key: storageKey,
+            legacyKey: 'lowdefy_locale',
+            storage: window.localStorage
+        }) ?? 'auto';
     });
     const browserLocale = useMemo(()=>{
         if (supportedCodes.length === 0) return undefined;
@@ -58,12 +67,14 @@ function useLocale({ i18n, antdLocaleLoaders, antdXLocaleLoaders, dayjsLocaleMap
     ]);
     const setPreference = useCallback((code)=>{
         if (code === 'auto') {
-            window.localStorage?.removeItem('lowdefy_locale');
+            window.localStorage?.removeItem(storageKey);
         } else {
-            window.localStorage?.setItem('lowdefy_locale', code);
+            window.localStorage?.setItem(storageKey, code);
         }
         setUserPreference(code ?? 'auto');
-    }, []);
+    }, [
+        storageKey
+    ]);
     window.__lowdefy_setLocale = setPreference;
     const active = resolveActive({
         userPreference,
@@ -75,6 +86,8 @@ function useLocale({ i18n, antdLocaleLoaders, antdXLocaleLoaders, dayjsLocaleMap
     window.__lowdefy_supported_locales = i18n?.locales ?? [];
     const [antdLocale, setAntdLocale] = useState(null);
     const [antdXLocale, setAntdXLocale] = useState(null);
+    // The engine trace reads the antd strings in use as config text; it has no antd dependency.
+    window.__lowdefy_antd_locale = antdLocale ?? defaultAntdLocale;
     useEffect(()=>{
         let cancelled = false;
         loadAntdLocale({