zcw-shared 1.31.0 → 1.32.0

package/dist/vue-hooks/browser/useFileUpload.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFileUpload.js","sourceRoot":"","sources":["../../../src/vue-hooks/browser/useFileUpload.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useFileUpload.js","sourceRoot":"","sources":["../../../src/vue-hooks/browser/useFileUpload.ts"],"names":[],"mappings":"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"}

package/dist/vue-hooks/state/handleUserInvalid.d.ts

@@ -0,0 +1,10 @@
+export interface HandleUserInvalidParams {
+    token: {
+        clearTokens: () => void;
+    };
+    user: {
+        clearUser: () => void;
+    };
+    onLoggedOut?: () => void;
+}
+export declare function handleUserInvalid(params: HandleUserInvalidParams): void;

package/dist/vue-hooks/state/handleUserInvalid.js

@@ -0,0 +1,7 @@
+export function handleUserInvalid(params) {
+    params.token.clearTokens();
+    params.user.clearUser();
+    if (params.onLoggedOut)
+        params.onLoggedOut();
+}
+//# sourceMappingURL=handleUserInvalid.js.map

package/dist/vue-hooks/state/handleUserInvalid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleUserInvalid.js","sourceRoot":"","sources":["../../../src/vue-hooks/state/handleUserInvalid.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,iBAAiB,CAAC,MAA+B;IAC/D,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAA;IAC1B,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;IACvB,IAAI,MAAM,CAAC,WAAW;QAAE,MAAM,CAAC,WAAW,EAAE,CAAA;AAC9C,CAAC"}

package/dist/vue-hooks/state/useGlobalSettingsManager.d.ts

@@ -0,0 +1,50 @@
+import type { Ref } from 'vue';
+import type { setTimeout, clearTimeout } from '../../../references/timer.d';
+import type { Storage } from '../../../references/storage.d';
+export interface UseGlobalSettingsManagerEnvironment {
+    vue: {
+        ref: <T>(value: T) => Ref<T>;
+        computed: <T>(getter: () => T) => Ref<T>;
+        watchEffect: (effect: () => void) => void;
+        onMounted: (cb: () => void) => void;
+        onUnmounted: (cb: () => void) => void;
+    };
+    host: {
+        setTimeout: typeof setTimeout;
+        clearTimeout: typeof clearTimeout;
+        now: () => number;
+    };
+    storage: {
+        getItem: Storage['getItem'];
+        setItem: Storage['setItem'];
+        removeItem: Storage['removeItem'];
+    };
+}
+export interface TokenReadonly {
+    accessToken: Ref<string | null>;
+    isAuthenticated: Ref<boolean>;
+}
+export interface FetchSettingsResult<T> {
+    data: T;
+    version?: string;
+}
+export interface UseGlobalSettingsManagerOptions<T> {
+    fetchSettingsFn: (accessToken: string) => Promise<FetchSettingsResult<T>>;
+    storageKeys?: {
+        data?: string;
+        meta?: string;
+    };
+    autoFetchOnMount?: boolean;
+    refreshIntervalMs?: number;
+}
+export interface UseGlobalSettingsManagerReturn<T> {
+    settings: Ref<T | null>;
+    version: Ref<string | null>;
+    lastUpdatedAt: Ref<number | null>;
+    isLoading: Ref<boolean>;
+    error: Ref<string | null>;
+    hasSettings: Ref<boolean>;
+    refresh: (force?: boolean) => Promise<boolean>;
+    clear: () => void;
+}
+export declare function useGlobalSettingsManager<T = Record<string, any>>(token: TokenReadonly, options: UseGlobalSettingsManagerOptions<T>, env: UseGlobalSettingsManagerEnvironment): UseGlobalSettingsManagerReturn<T>;

package/dist/vue-hooks/state/useGlobalSettingsManager.js

@@ -0,0 +1,129 @@
+export function useGlobalSettingsManager(token, options, env) {
+    const keys = {
+        data: options.storageKeys?.data ?? 'gsettings:data',
+        meta: options.storageKeys?.meta ?? 'gsettings:meta'
+    };
+    const autoFetchOnMount = options.autoFetchOnMount ?? true;
+    const refreshIntervalMs = options.refreshIntervalMs;
+    const settings = env.vue.ref(null);
+    const version = env.vue.ref(null);
+    const lastUpdatedAt = env.vue.ref(null);
+    const isLoading = env.vue.ref(false);
+    const error = env.vue.ref(null);
+    const hasSettings = env.vue.computed(() => settings.value != null);
+    let inFlight = null;
+    let refreshTimer = null;
+    let hasMounted = false;
+    function persist() {
+        try {
+            if (settings.value != null)
+                env.storage.setItem(keys.data, JSON.stringify(settings.value));
+            else
+                env.storage.removeItem(keys.data);
+            const meta = version.value || lastUpdatedAt.value != null ? JSON.stringify({ version: version.value, lastUpdatedAt: lastUpdatedAt.value }) : null;
+            if (meta)
+                env.storage.setItem(keys.meta, meta);
+            else
+                env.storage.removeItem(keys.meta);
+        }
+        catch { }
+    }
+    function rehydrate() {
+        try {
+            const raw = env.storage.getItem(keys.data);
+            const meta = env.storage.getItem(keys.meta);
+            if (raw)
+                settings.value = JSON.parse(raw);
+            if (meta) {
+                const m = JSON.parse(meta);
+                version.value = m?.version ?? null;
+                lastUpdatedAt.value = typeof m?.lastUpdatedAt === 'number' ? m.lastUpdatedAt : null;
+            }
+        }
+        catch { }
+    }
+    function clearTimer() {
+        if (refreshTimer) {
+            env.host.clearTimeout(refreshTimer);
+            refreshTimer = null;
+        }
+    }
+    function scheduleRefresh() {
+        clearTimer();
+        if (!refreshIntervalMs)
+            return;
+        if (!token.isAuthenticated.value || !token.accessToken.value)
+            return;
+        refreshTimer = env.host.setTimeout(() => {
+            void refresh();
+        }, refreshIntervalMs);
+    }
+    async function refresh(force = false) {
+        if (!token.isAuthenticated.value || !token.accessToken.value)
+            return false;
+        if (inFlight)
+            return inFlight;
+        const run = async () => {
+            try {
+                isLoading.value = true;
+                error.value = null;
+                const res = await options.fetchSettingsFn(token.accessToken.value);
+                const nextVersion = res.version ?? null;
+                const isSame = !force && nextVersion != null && version.value === nextVersion;
+                if (isSame) {
+                    lastUpdatedAt.value = env.host.now();
+                    persist();
+                    return true;
+                }
+                settings.value = res.data;
+                version.value = nextVersion;
+                lastUpdatedAt.value = env.host.now();
+                persist();
+                return true;
+            }
+            catch (e) {
+                error.value = e?.message ?? 'fetch settings error';
+                return false;
+            }
+            finally {
+                isLoading.value = false;
+                inFlight = null;
+                scheduleRefresh();
+            }
+        };
+        inFlight = run();
+        return inFlight;
+    }
+    function clear() {
+        settings.value = null;
+        version.value = null;
+        lastUpdatedAt.value = null;
+        error.value = null;
+        persist();
+        clearTimer();
+    }
+    env.vue.onMounted(() => {
+        rehydrate();
+        hasMounted = true;
+        if (autoFetchOnMount && token.isAuthenticated.value && token.accessToken.value) {
+            void refresh(true);
+        }
+        else {
+            scheduleRefresh();
+        }
+    });
+    env.vue.onUnmounted(() => {
+        clearTimer();
+    });
+    env.vue.watchEffect(() => {
+        if (!hasMounted)
+            return;
+        if (!token.isAuthenticated.value || !token.accessToken.value) {
+            clear();
+            return;
+        }
+        scheduleRefresh();
+    });
+    return { settings, version, lastUpdatedAt, isLoading, error, hasSettings, refresh, clear };
+}
+//# sourceMappingURL=useGlobalSettingsManager.js.map

package/dist/vue-hooks/state/useGlobalSettingsManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGlobalSettingsManager.js","sourceRoot":"","sources":["../../../src/vue-hooks/state/useGlobalSettingsManager.ts"],"names":[],"mappings":"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"}

package/dist/vue-hooks/state/useSystemSettingsManager.d.ts

@@ -0,0 +1,45 @@
+import type { Ref } from 'vue';
+import type { setTimeout, clearTimeout } from '../../../references/timer.d';
+import type { Storage } from '../../../references/storage.d';
+export interface UseSystemSettingsManagerEnvironment {
+    vue: {
+        ref: <T>(value: T) => Ref<T>;
+        computed: <T>(getter: () => T) => Ref<T>;
+        onMounted: (cb: () => void) => void;
+        onUnmounted: (cb: () => void) => void;
+    };
+    host: {
+        setTimeout: typeof setTimeout;
+        clearTimeout: typeof clearTimeout;
+        now: () => number;
+    };
+    storage: {
+        getItem: Storage['getItem'];
+        setItem: Storage['setItem'];
+        removeItem: Storage['removeItem'];
+    };
+}
+export interface FetchSystemSettingsResult<T> {
+    data: T;
+    version?: string;
+}
+export interface UseSystemSettingsManagerOptions<T> {
+    fetchSettingsFn: () => Promise<FetchSystemSettingsResult<T>>;
+    storageKeys?: {
+        data?: string;
+        meta?: string;
+    };
+    autoFetchOnMount?: boolean;
+    refreshIntervalMs?: number;
+}
+export interface UseSystemSettingsManagerReturn<T> {
+    settings: Ref<T | null>;
+    version: Ref<string | null>;
+    lastUpdatedAt: Ref<number | null>;
+    isLoading: Ref<boolean>;
+    error: Ref<string | null>;
+    hasSettings: Ref<boolean>;
+    refresh: (force?: boolean) => Promise<boolean>;
+    clear: () => void;
+}
+export declare function useSystemSettingsManager<T = Record<string, any>>(options: UseSystemSettingsManagerOptions<T>, env: UseSystemSettingsManagerEnvironment): UseSystemSettingsManagerReturn<T>;

package/dist/vue-hooks/state/useSystemSettingsManager.js

@@ -0,0 +1,102 @@
+export function useSystemSettingsManager(options, env) {
+    const keys = {
+        data: options.storageKeys?.data ?? 'syssettings:data',
+        meta: options.storageKeys?.meta ?? 'syssettings:meta'
+    };
+    const autoFetchOnMount = options.autoFetchOnMount ?? true;
+    const refreshIntervalMs = options.refreshIntervalMs;
+    const settings = env.vue.ref(null);
+    const version = env.vue.ref(null);
+    const lastUpdatedAt = env.vue.ref(null);
+    const isLoading = env.vue.ref(false);
+    const error = env.vue.ref(null);
+    const hasSettings = env.vue.computed(() => settings.value != null);
+    let inFlight = null;
+    let timer = null;
+    function persist() {
+        try {
+            if (settings.value != null)
+                env.storage.setItem(keys.data, JSON.stringify(settings.value));
+            else
+                env.storage.removeItem(keys.data);
+            const meta = JSON.stringify({ version: version.value, lastUpdatedAt: lastUpdatedAt.value });
+            env.storage.setItem(keys.meta, meta);
+        }
+        catch { }
+    }
+    function rehydrate() {
+        try {
+            const raw = env.storage.getItem(keys.data);
+            const meta = env.storage.getItem(keys.meta);
+            if (raw)
+                settings.value = JSON.parse(raw);
+            if (meta) {
+                const m = JSON.parse(meta);
+                version.value = m?.version ?? null;
+                lastUpdatedAt.value = typeof m?.lastUpdatedAt === 'number' ? m.lastUpdatedAt : null;
+            }
+        }
+        catch { }
+    }
+    function clearTimer() { if (timer) {
+        env.host.clearTimeout(timer);
+        timer = null;
+    } }
+    function schedule() {
+        clearTimer();
+        if (!refreshIntervalMs)
+            return;
+        timer = env.host.setTimeout(() => { void refresh(); }, refreshIntervalMs);
+    }
+    async function refresh(force = false) {
+        if (inFlight)
+            return inFlight;
+        const run = async () => {
+            try {
+                isLoading.value = true;
+                error.value = null;
+                const res = await options.fetchSettingsFn();
+                const nextVersion = res.version ?? null;
+                if (!force && nextVersion != null && version.value === nextVersion) {
+                    lastUpdatedAt.value = env.host.now();
+                    persist();
+                    return true;
+                }
+                settings.value = res.data;
+                version.value = nextVersion;
+                lastUpdatedAt.value = env.host.now();
+                persist();
+                return true;
+            }
+            catch (e) {
+                error.value = e?.message ?? 'fetch system settings error';
+                return false;
+            }
+            finally {
+                isLoading.value = false;
+                inFlight = null;
+                schedule();
+            }
+        };
+        inFlight = run();
+        return inFlight;
+    }
+    function clear() {
+        settings.value = null;
+        version.value = null;
+        lastUpdatedAt.value = null;
+        error.value = null;
+        persist();
+        clearTimer();
+    }
+    env.vue.onMounted(() => {
+        rehydrate();
+        if (autoFetchOnMount)
+            void refresh(true);
+        else
+            schedule();
+    });
+    env.vue.onUnmounted(() => { clearTimer(); });
+    return { settings, version, lastUpdatedAt, isLoading, error, hasSettings, refresh, clear };
+}
+//# sourceMappingURL=useSystemSettingsManager.js.map

package/dist/vue-hooks/state/useSystemSettingsManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSystemSettingsManager.js","sourceRoot":"","sources":["../../../src/vue-hooks/state/useSystemSettingsManager.ts"],"names":[],"mappings":"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"}

package/dist/vue-hooks/state/useToken.d.ts

@@ -0,0 +1,36 @@
+import type { setTimeout as SetTimeout } from '../../../references/timer.d';
+export interface UseTokenEnvironment<VueRef, VueComputed> {
+    vue: {
+        ref: <T>(value: T) => VueRef;
+        computed: <T>(getter: () => T) => VueComputed;
+        watch: (source: any, cb: (...args: any[]) => void, options?: any) => void;
+        onMounted: (fn: () => void) => void;
+        onUnmounted: (fn: () => void) => void;
+    };
+    host: {
+        getItem: (key: string) => string | null;
+        setItem: (key: string, value: string) => void;
+        removeItem: (key: string) => void;
+        now: () => number;
+        setTimeout: typeof SetTimeout;
+        clearTimeout: (id: any) => void;
+    };
+}
+export interface UseTokenOptions {
+    key?: string;
+    initialToken?: string | null;
+    initialTtlMs?: number;
+    persist?: boolean;
+}
+export interface UseTokenState<VueRef, VueComputed> {
+    token: VueRef;
+    expiresAt: VueRef;
+    isAuthenticated: VueComputed;
+    isExpired: VueComputed;
+    remainingMs: VueComputed;
+    setToken: (value: string | null, ttlMs?: number | null) => void;
+    clearToken: () => void;
+    refresh: (ttlMs: number) => void;
+    reload: () => void;
+}
+export declare function useToken<VueRef, VueComputed>(options: UseTokenOptions, env: UseTokenEnvironment<VueRef, VueComputed>): UseTokenState<VueRef, VueComputed>;

package/dist/vue-hooks/state/useToken.js

@@ -0,0 +1,121 @@
+export function useToken(options, env) {
+    const key = options.key ?? 'auth_token';
+    const persist = options.persist !== false;
+    const token = env.vue.ref(options.initialToken ?? null);
+    const expiresAt = env.vue.ref(null);
+    let expiryTimer = null;
+    function scheduleExpiryCheck() {
+        if (expiryTimer)
+            env.host.clearTimeout(expiryTimer);
+        const expires = expiresAt.value;
+        if (expires == null)
+            return;
+        const delay = Math.max(0, expires - env.host.now());
+        expiryTimer = env.host.setTimeout(() => {
+        }, delay);
+    }
+    function readFromStorage() {
+        const raw = env.host.getItem(key);
+        if (!raw) {
+            token.value = options.initialToken ?? null;
+            if (options.initialTtlMs != null && options.initialTtlMs > 0) {
+                expiresAt.value = env.host.now() + options.initialTtlMs;
+            }
+            else {
+                expiresAt.value = null;
+            }
+            scheduleExpiryCheck();
+            return;
+        }
+        try {
+            const parsed = JSON.parse(raw);
+            token.value = parsed.token ?? null;
+            expiresAt.value = typeof parsed.expiresAt === 'number' ? parsed.expiresAt : null;
+        }
+        catch {
+            ;
+            token.value = raw;
+            expiresAt.value = null;
+        }
+        scheduleExpiryCheck();
+    }
+    function writeToStorage() {
+        if (!persist)
+            return;
+        const t = token.value;
+        const e = expiresAt.value;
+        try {
+            env.host.setItem(key, JSON.stringify({ token: t, expiresAt: e }));
+        }
+        catch {
+        }
+    }
+    function setToken(value, ttlMs) {
+        ;
+        token.value = value;
+        if (ttlMs && ttlMs > 0) {
+            ;
+            expiresAt.value = env.host.now() + ttlMs;
+        }
+        else if (ttlMs === 0 || ttlMs === null) {
+            ;
+            expiresAt.value = null;
+        }
+        scheduleExpiryCheck();
+        writeToStorage();
+    }
+    function clearToken() {
+        ;
+        token.value = null;
+        expiresAt.value = null;
+        if (expiryTimer)
+            env.host.clearTimeout(expiryTimer);
+        if (persist)
+            env.host.removeItem(key);
+    }
+    function refresh(ttlMs) {
+        if (ttlMs > 0 && token.value) {
+            ;
+            expiresAt.value = env.host.now() + ttlMs;
+            scheduleExpiryCheck();
+            writeToStorage();
+        }
+    }
+    function reload() {
+        readFromStorage();
+    }
+    const isExpired = env.vue.computed(() => {
+        const e = expiresAt.value;
+        if (e == null)
+            return false;
+        return env.host.now() >= e;
+    });
+    const isAuthenticated = env.vue.computed(() => {
+        const t = token.value;
+        return !!t && !isExpired.value;
+    });
+    const remainingMs = env.vue.computed(() => {
+        const e = expiresAt.value;
+        if (e == null)
+            return Infinity;
+        return e - env.host.now();
+    });
+    readFromStorage();
+    env.vue.watch(() => [token.value, expiresAt.value], () => writeToStorage(), { deep: false });
+    env.vue.onUnmounted(() => {
+        if (expiryTimer)
+            env.host.clearTimeout(expiryTimer);
+    });
+    return {
+        token,
+        expiresAt,
+        isAuthenticated,
+        isExpired,
+        remainingMs,
+        setToken,
+        clearToken,
+        refresh,
+        reload
+    };
+}
+//# sourceMappingURL=useToken.js.map

package/dist/vue-hooks/state/useToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToken.js","sourceRoot":"","sources":["../../../src/vue-hooks/state/useToken.ts"],"names":[],"mappings":"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"}

package/dist/vue-hooks/state/useTokenManager.d.ts

@@ -0,0 +1,55 @@
+import type { Ref } from 'vue';
+import type { setTimeout, clearTimeout } from '../../../references/timer.d';
+import type { Storage } from '../../../references/storage.d';
+export interface UseTokenManagerState {
+    accessToken: Ref<string | null>;
+    refreshToken: Ref<string | null>;
+    expiresAt: Ref<number | null>;
+    isRefreshing: Ref<boolean>;
+    error: Ref<string | null>;
+    isAuthenticated: Ref<boolean>;
+}
+export interface UseTokenManagerOptions {
+    refreshThresholdMs?: number;
+    storageKeys?: {
+        access?: string;
+        refresh?: string;
+        expiresAt?: string;
+    };
+    refreshFn?: (refreshToken: string) => Promise<{
+        accessToken: string;
+        refreshToken?: string;
+        expiresAt: number;
+    } | null>;
+}
+export interface UseTokenManagerEnvironment {
+    vue: {
+        ref: <T>(value: T) => Ref<T>;
+        computed: <T>(getter: () => T) => Ref<T>;
+        watchEffect: (effect: () => void) => void;
+        onMounted: (cb: () => void) => void;
+        onUnmounted: (cb: () => void) => void;
+    };
+    host: {
+        setTimeout: typeof setTimeout;
+        clearTimeout: typeof clearTimeout;
+        now: () => number;
+    };
+    storage: {
+        getItem: Storage['getItem'];
+        setItem: Storage['setItem'];
+        removeItem: Storage['removeItem'];
+    };
+}
+export interface SetTokensInput {
+    accessToken: string;
+    refreshToken?: string | null;
+    expiresAt?: number | null;
+    expiresInSeconds?: number | null;
+}
+export interface UseTokenManagerReturn extends UseTokenManagerState {
+    setTokens: (input: SetTokensInput) => void;
+    clearTokens: () => void;
+    forceRefresh: () => Promise<boolean>;
+}
+export declare function useTokenManager(options: UseTokenManagerOptions, env: UseTokenManagerEnvironment): UseTokenManagerReturn;