@ploykit/ui 0.0.0-stage → 0.1.1

package/dist/provider/PloykitProvider.js

@@ -0,0 +1,240 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useState } from 'react';
+import { QueryClient, QueryClientProvider, useQuery, useQueryClient } from '@tanstack/react-query';
+import { api, ApiError, setWorkspaceIdProvider } from '@ploykit/client';
+export const queryKeys = {
+    auth: ['auth'],
+    me: ['auth', 'me'],
+    sessions: ['auth', 'sessions'],
+    tokens: ['auth', 'tokens'],
+    workspace: ['workspace'],
+    workspaceList: ['workspace', 'list'],
+    members: (wsId) => ['workspace', wsId, 'members'],
+    invitations: (wsId) => ['workspace', wsId, 'invitations'],
+    shareLinks: (wsId) => ['workspace', wsId, 'share-links'],
+    myInvitations: ['workspace', 'my-invitations'],
+    audit: (wsId, q) => ['audit', wsId, q],
+    usage: (wsId) => ['usage', wsId],
+    billing: ['billing'],
+    billingSubscription: (workspaceId) => ['billing', 'subscription', workspaceId],
+    billingPlans: ['billing', 'plans'],
+    notifications: ['notifications'], // 元组：可作前缀失效（原为裸字符串）
+    notificationPrefs: ['notifications', 'preferences'],
+    webhooks: (wsId) => ['webhooks', wsId],
+    admin: ['admin'],
+};
+function createDefaultQueryClient() {
+    return new QueryClient({
+        defaultOptions: {
+            queries: {
+                staleTime: 30_000,
+                retry: (failureCount, error) => {
+                    if (error instanceof ApiError && error.status >= 400 && error.status < 500)
+                        return false;
+                    return failureCount < 1;
+                },
+                refetchOnWindowFocus: false,
+            },
+        },
+    });
+}
+const WS_URL_PARAM = 'ws';
+const wsStorageKey = (userId) => `pk.ws.${userId}`;
+function readWsIdFromUrl() {
+    if (typeof window === 'undefined')
+        return null;
+    try {
+        return new URLSearchParams(window.location.search).get(WS_URL_PARAM) || null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeWsIdToUrl(id) {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        const url = new URL(window.location.href);
+        url.searchParams.set(WS_URL_PARAM, id);
+        window.history.replaceState(window.history.state, '', url.href);
+    }
+    catch {
+        /* 受限环境降级：仅不写 URL，上下文本体不受影响 */
+    }
+}
+function removeWsIdFromUrl() {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        const url = new URL(window.location.href);
+        if (!url.searchParams.has(WS_URL_PARAM))
+            return;
+        url.searchParams.delete(WS_URL_PARAM);
+        window.history.replaceState(window.history.state, '', url.href);
+    }
+    catch {
+        /* 同上：静默降级 */
+    }
+}
+function readStoredWsId(userId) {
+    if (typeof window === 'undefined')
+        return null;
+    try {
+        return window.localStorage.getItem(wsStorageKey(userId)) || null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeStoredWsId(userId, id) {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        window.localStorage.setItem(wsStorageKey(userId), id);
+    }
+    catch {
+        /* localStorage 不可用（隐私模式/配额）：降级为内存 + URL 两层 */
+    }
+}
+function removeStoredWsId(userId) {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        window.localStorage.removeItem(wsStorageKey(userId));
+    }
+    catch {
+        /* 静默降级 */
+    }
+}
+export const AuthContext = createContext(null);
+export const WorkspaceContext = createContext(null);
+export function useAuthCtx() {
+    const ctx = useContext(AuthContext);
+    if (!ctx)
+        throw new Error('must be used within PloykitProvider');
+    return ctx;
+}
+export function useWorkspaceCtx() {
+    const ctx = useContext(WorkspaceContext);
+    if (!ctx)
+        throw new Error('must be used within PloykitProvider');
+    return ctx;
+}
+export function PloykitProvider({ children, queryClient }) {
+    const [qc] = useState(() => queryClient ?? createDefaultQueryClient());
+    useEffect(() => {
+        qc.setQueryDefaults(queryKeys.admin, { staleTime: 0 });
+    }, [qc]);
+    return (_jsx(QueryClientProvider, { client: qc, children: _jsx(AuthLayer, { children: _jsx(WorkspaceLayer, { children: children }) }) }));
+}
+function AuthLayer({ children }) {
+    const qc = useQueryClient();
+    const meQ = useQuery({
+        queryKey: queryKeys.me,
+        queryFn: () => api.get('/auth/me').catch((err) => {
+            if (err instanceof ApiError && err.status === 401)
+                return null;
+            throw err;
+        }),
+    });
+    const wsQ = useQuery({
+        queryKey: queryKeys.workspaceList,
+        queryFn: () => api.get('/api/workspaces').catch((err) => {
+            if (err instanceof ApiError && err.status === 401)
+                return [];
+            throw err;
+        }),
+    });
+    const user = meQ.data ?? null;
+    const workspaces = Array.isArray(wsQ.data) ? wsQ.data : [];
+    const refresh = useCallback(async () => {
+        await Promise.all([
+            qc.invalidateQueries({ queryKey: queryKeys.auth }),
+            qc.invalidateQueries({ queryKey: queryKeys.workspace }),
+        ]);
+    }, [qc]);
+    const logout = useCallback(async () => {
+        const me = qc.getQueryData(queryKeys.me);
+        if (me?.id)
+            removeStoredWsId(me.id);
+        await api.post('/auth/logout').catch(() => { });
+        qc.setQueryData(queryKeys.me, null);
+        qc.setQueryData(queryKeys.workspaceList, []);
+        qc.removeQueries();
+    }, [qc]);
+    const value = useMemo(() => ({
+        user,
+        workspaces,
+        loading: meQ.isPending || wsQ.isPending,
+        error: meQ.error ?? wsQ.error ?? null,
+        refresh,
+        logout,
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }), [user, workspaces, meQ.isPending, wsQ.isPending, meQ.error, wsQ.error, refresh, logout]);
+    return _jsx(AuthContext.Provider, { value: value, children: children });
+}
+function WorkspaceLayer({ children }) {
+    const { user, workspaces } = useAuthCtx();
+    const [currentId, setCurrentId] = useState(null);
+    const userId = user?.id;
+    useEffect(() => {
+        if (!user || workspaces.length === 0 || currentId)
+            return;
+        const uid = user.id;
+        const candidate = readWsIdFromUrl() ?? (uid ? readStoredWsId(uid) : null);
+        if (candidate && workspaces.some((ws) => ws.id === candidate)) {
+            setCurrentId(candidate);
+            if (uid)
+                writeStoredWsId(uid, candidate);
+            return;
+        }
+        if (candidate) {
+            if (uid)
+                removeStoredWsId(uid);
+            removeWsIdFromUrl();
+        }
+        setCurrentId(workspaces[0].id);
+    }, [user, workspaces, currentId]);
+    useEffect(() => {
+        if (currentId && !workspaces.some((ws) => ws.id === currentId)) {
+            setCurrentId(workspaces[0]?.id ?? null);
+            if (userId)
+                removeStoredWsId(userId);
+            removeWsIdFromUrl();
+        }
+    }, [workspaces, currentId, userId]);
+    useEffect(() => {
+        if (typeof window === 'undefined')
+            return;
+        const onPopState = () => {
+            const urlId = readWsIdFromUrl();
+            if (!urlId)
+                return;
+            setCurrentId((prev) => (prev === urlId ? prev : urlId));
+            if (userId)
+                writeStoredWsId(userId, urlId);
+        };
+        window.addEventListener('popstate', onPopState);
+        return () => window.removeEventListener('popstate', onPopState);
+    }, [userId]);
+    const current = workspaces.find((ws) => ws.id === currentId) ?? null;
+    setWorkspaceIdProvider(() => current?.id ?? null);
+    const switchTo = useCallback((id) => {
+        setCurrentId(id);
+        if (userId)
+            writeStoredWsId(userId, id);
+        writeWsIdToUrl(id);
+    }, [userId]);
+    const clear = useCallback(() => {
+        setCurrentId(null);
+        if (userId)
+            removeStoredWsId(userId);
+        removeWsIdFromUrl();
+    }, [userId]);
+    const value = useMemo(() => ({
+        current,
+        switchTo,
+        clear,
+    }), [current, switchTo, clear]);
+    return _jsx(WorkspaceContext.Provider, { value: value, children: children });
+}

package/dist/realtime.d.ts

@@ -0,0 +1,3 @@
+import { WsClient, type WsClientOptions } from '@ploykit/client';
+export declare function defaultWsUrl(workspaceId?: string | null): string;
+export declare function createWsClient(url: () => string, options?: Omit<WsClientOptions, 'url'>): WsClient;

package/dist/realtime.js

@@ -0,0 +1,11 @@
+import { WsClient } from '@ploykit/client';
+export function defaultWsUrl(workspaceId) {
+    const proto = typeof location === 'undefined' ? 'ws' : location.protocol === 'https:' ? 'wss' : 'ws';
+    const host = typeof location === 'undefined' ? 'localhost' : location.host;
+    return workspaceId
+        ? `${proto}://${host}/ws?workspace_id=${encodeURIComponent(workspaceId)}`
+        : `${proto}://${host}/ws`;
+}
+export function createWsClient(url, options) {
+    return new WsClient({ ...options, url });
+}

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "@ploykit/ui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-router": "^7.0.0",
+    "tailwindcss": "^4.0.0"
+  },
+  "dependencies": {
+    "@base-ui/react": "^1.8.0",
+    "@hookform/resolvers": "^5.9.1",
+    "@ploykit/client": "^0.2.0",
+    "@ploykit/runtime": "^0.1.0",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "lucide-react": "^1.52.0",
+    "react-hook-form": "^7.0.0",
+    "sonner": "^2.0.8",
+    "tailwind-merge": "^3.7.0",
+    "zod": "^4.0.0"
+  },
+  "description": "React 前端壳：登录/工作区/计费的 Headless Hook + 默认页面。产物为 ESM（相对导入无扩展名，消费方需经 vite/esbuild 等打包器解析）；exports 的 development 条件指向源码，供 monorepo 开发期直出消费。",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.3.3",
+    "@testing-library/dom": "^10.4.2",
+    "@testing-library/jest-dom": "^7.0.1",
+    "@testing-library/react": "^16.3.3",
+    "jsdom": "^29.1.1",
+    "react-router": "7.18.4",
+    "tailwindcss": "^4.3.3",
+    "typescript": "^5.9.3",
+    "vitest": "^5.0.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/haozing/ploykit.git",
+    "directory": "packages/ui"
+  }
+}