mtmsdk 0.0.50 → 0.0.52

package/src/supabase/auth-provider.tsx

@@ -1,67 +1,67 @@
-"use client";
-
-import type { Session } from "@supabase/supabase-js";
-import { createContext, useContext, useEffect, useMemo, useState, type PropsWithChildren, type ReactNode } from "react";
-import { useSupabaseBrowser } from "./context";
-
-interface SupabaseAuthContextType {
-  session: Session | null;
-  token: string | undefined;
-  isLoading: boolean;
-}
-
-const SupabaseAuthContext = createContext<SupabaseAuthContextType | undefined>(undefined);
-
-export function useSupabaseAuth() {
-  const context = useContext(SupabaseAuthContext);
-  if (context === undefined) {
-    throw new Error("useSupabaseAuth must be used within a SupabaseAuthProvider");
-  }
-  return context;
-}
-
-export function SupabaseAuthProvider({ children }: PropsWithChildren): ReactNode {
-  const sb = useSupabaseBrowser();
-  const [session, setSession] = useState<Session | null>(null);
-  const [isLoading, setIsLoading] = useState(true);
-
-  useEffect(() => {
-    let mounted = true;
-
-    async function loadSession() {
-      const {
-        data: { session },
-      } = await sb.auth.getSession();
-      if (mounted) {
-        setSession(session);
-        setIsLoading(false);
-      }
-    }
-    loadSession();
-
-    const {
-      data: { subscription },
-    } = sb.auth.onAuthStateChange((_event, session) => {
-      if (mounted) {
-        setSession(session);
-        setIsLoading(false);
-      }
-    });
-
-    return () => {
-      mounted = false;
-      subscription.unsubscribe();
-    };
-  }, [sb]);
-
-  const value = useMemo(
-    () => ({
-      session,
-      token: session?.access_token,
-      isLoading,
-    }),
-    [session, isLoading],
-  );
-
-  return <SupabaseAuthContext.Provider value={value}>{children}</SupabaseAuthContext.Provider>;
-}
+"use client";
+
+import type { Session } from "@supabase/supabase-js";
+import { createContext, useContext, useEffect, useMemo, useState, type PropsWithChildren, type ReactNode } from "react";
+import { useSupabaseBrowser } from "./context";
+
+interface SupabaseAuthContextType {
+  session: Session | null;
+  token: string | undefined;
+  isLoading: boolean;
+}
+
+const SupabaseAuthContext = createContext<SupabaseAuthContextType | undefined>(undefined);
+
+export function useSupabaseAuth() {
+  const context = useContext(SupabaseAuthContext);
+  if (context === undefined) {
+    throw new Error("useSupabaseAuth must be used within a SupabaseAuthProvider");
+  }
+  return context;
+}
+
+export function SupabaseAuthProvider({ children }: PropsWithChildren): ReactNode {
+  const sb = useSupabaseBrowser();
+  const [session, setSession] = useState<Session | null>(null);
+  const [isLoading, setIsLoading] = useState(true);
+
+  useEffect(() => {
+    let mounted = true;
+
+    async function loadSession() {
+      const {
+        data: { session },
+      } = await sb.auth.getSession();
+      if (mounted) {
+        setSession(session);
+        setIsLoading(false);
+      }
+    }
+    loadSession();
+
+    const {
+      data: { subscription },
+    } = sb.auth.onAuthStateChange((_event, session) => {
+      if (mounted) {
+        setSession(session);
+        setIsLoading(false);
+      }
+    });
+
+    return () => {
+      mounted = false;
+      subscription.unsubscribe();
+    };
+  }, [sb]);
+
+  const value = useMemo(
+    () => ({
+      session,
+      token: session?.access_token,
+      isLoading,
+    }),
+    [session, isLoading],
+  );
+
+  return <SupabaseAuthContext.Provider value={value}>{children}</SupabaseAuthContext.Provider>;
+}

package/src/supabase/context.tsx

@@ -1,51 +1,51 @@
-"use client";
-
-import { createBrowserClient } from "@supabase/ssr";
-import { createContext, type ReactNode, useContext, useMemo } from "react";
-import type { TypedSupabaseClient } from "../types";
-import type { Database } from "../types/database.types";
-
-let client: TypedSupabaseClient | undefined;
-
-export function getSupabaseBrowserClient(url?: string, key?: string): TypedSupabaseClient {
-  if (url && key) {
-    return createBrowserClient<Database>(url, key);
-  }
-  if (!client) {
-    client = createBrowserClient<Database>(
-      // biome-ignore lint/style/noNonNullAssertion: .
-      process.env.NEXT_PUBLIC_SUPABASE_URL!,
-      // biome-ignore lint/style/noNonNullAssertion: .
-      process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
-    );
-  }
-  // biome-ignore lint/style/noNonNullAssertion: 已经确保了初始化
-  return client!;
-}
-
-export const SupabaseContext = createContext<TypedSupabaseClient | undefined>(undefined);
-
-export function useSupabaseContext(): TypedSupabaseClient {
-  const ctx = useContext(SupabaseContext);
-  if (!ctx) {
-    throw new Error("useSupabaseContext must be used within a SupabaseProvider");
-  }
-  return ctx;
-}
-export const useSupabaseBrowser = useSupabaseContext;
-
-interface SupabaseClientProviderProps {
-  children: ReactNode;
-  publicKey?: string;
-  url?: string;
-}
-
-export const SupabaseClientProvider = ({ children, publicKey, url }: SupabaseClientProviderProps): ReactNode => {
-  const client = useMemo(() => getSupabaseBrowserClient(url, publicKey), [url, publicKey]);
-
-  return (
-    <SupabaseContext.Provider value={client}>
-      {children}
-    </SupabaseContext.Provider>
-  );
-};
+"use client";
+
+import { createBrowserClient } from "@supabase/ssr";
+import { createContext, type ReactNode, useContext, useMemo } from "react";
+import type { TypedSupabaseClient } from "../types";
+import type { Database } from "../types/database.types";
+
+let client: TypedSupabaseClient | undefined;
+
+export function getSupabaseBrowserClient(url?: string, key?: string): TypedSupabaseClient {
+  if (url && key) {
+    return createBrowserClient<Database>(url, key);
+  }
+  if (!client) {
+    client = createBrowserClient<Database>(
+      // biome-ignore lint/style/noNonNullAssertion: .
+      process.env.NEXT_PUBLIC_SUPABASE_URL!,
+      // biome-ignore lint/style/noNonNullAssertion: .
+      process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!,
+    );
+  }
+  // biome-ignore lint/style/noNonNullAssertion: 已经确保了初始化
+  return client!;
+}
+
+export const SupabaseContext = createContext<TypedSupabaseClient | undefined>(undefined);
+
+export function useSupabaseContext(): TypedSupabaseClient {
+  const ctx = useContext(SupabaseContext);
+  if (!ctx) {
+    throw new Error("useSupabaseContext must be used within a SupabaseProvider");
+  }
+  return ctx;
+}
+export const useSupabaseBrowser = useSupabaseContext;
+
+interface SupabaseClientProviderProps {
+  children: ReactNode;
+  publicKey?: string;
+  url?: string;
+}
+
+export const SupabaseClientProvider = ({ children, publicKey, url }: SupabaseClientProviderProps): ReactNode => {
+  const client = useMemo(() => getSupabaseBrowserClient(url, publicKey), [url, publicKey]);
+
+  return (
+    <SupabaseContext.Provider value={client}>
+      {children}
+    </SupabaseContext.Provider>
+  );
+};

package/src/supabase/cursor-pagination.ts

@@ -1,155 +1,155 @@
-/**
- * 游标分页工具函数
- *
- * 提供类型安全的游标分页支持，配合 react-query 的 useInfiniteQuery 使用。
- *
- * @module mtmsdk/supabase/cursor-pagination
- */
-
-/**
- * 游标类型定义
- *
- * 使用复合游标 (updated_at + id) 确保分页的唯一性和稳定性
- */
-export interface CursorPagination {
-  cursor: string | null; // ISO 时间戳字符串, 如 "2026-01-20T08:00:00Z"
-  cursorId: string | null; // UUID 字符串
-}
-
-/**
- * 从数据列表中提取下一页游标
- *
- * @param items - 当前页的数据列表
- * @param limit - 每页数量
- * @param cursorField - 游标字段名 (默认 "updated_at")
- * @param idField - ID 字段名 (默认 "id")
- * @returns 下一页游标, 如果没有更多数据则返回 undefined
- *
- * @example
- * ```tsx
- * const { data, fetchNextPage, hasNextPage } = useInfiniteQuery({
- *   queryKey: ['projects', kw],
- *   queryFn: async ({ pageParam }) => {
- *     const { data } = await sb.rpc('audit_project_list_cursor', {
- *       p_cursor: pageParam?.cursor ?? null,
- *       p_cursor_id: pageParam?.cursorId ?? null,
- *       p_limit: 20,
- *       p_kw: kw
- *     });
- *     return data ?? [];
- *   },
- *   getNextPageParam: (lastPage) => getNextCursor(lastPage, 20),
- *   initialPageParam: null as CursorPagination | null
- * });
- * ```
- */
-export function getNextCursor<
-  T extends Record<string, unknown>,
->(
-  items: T[] | null | undefined,
-  limit: number,
-  cursorField: keyof T = "updated_at" as keyof T,
-  idField: keyof T = "id" as keyof T,
-): CursorPagination | undefined {
-  // 如果数据为空或数量小于 limit，说明已到达最后一页
-  if (!items || items.length < limit) {
-    return undefined;
-  }
-
-  // 获取最后一条记录
-  const lastItem = items[items.length - 1];
-  if (!lastItem) {
-    return undefined;
-  }
-
-  const cursorValue = lastItem[cursorField];
-  const idValue = lastItem[idField];
-
-  // 验证游标值有效性
-  if (cursorValue === undefined || cursorValue === null) {
-    return undefined;
-  }
-
-  return {
-    cursor: String(cursorValue),
-    cursorId: idValue != null ? String(idValue) : null,
-  };
-}
-
-/**
- * 将所有分页数据合并为单一列表
- *
- * @param pages - useInfiniteQuery 返回的 pages 数组
- * @returns 合并后的扁平数据列表
- *
- * @example
- * ```tsx
- * const { data } = useInfiniteQuery({ ... });
- * const allProjects = flattenPages(data?.pages);
- * ```
- */
-export function flattenPages<T>(
-  pages: T[][] | undefined,
-): T[] {
-  if (!pages) return [];
-  return pages.flat();
-}
-
-/**
- * 无限滚动分页状态
- */
-export interface InfiniteScrollState {
-  isLoading: boolean;
-  isFetchingNextPage: boolean;
-  hasNextPage: boolean;
-  error: Error | null;
-}
-
-/**
- * 创建 IntersectionObserver 用于无限滚动
- *
- * @param onIntersect - 当元素进入视口时的回调
- * @param options - IntersectionObserver 配置选项
- * @returns cleanup 函数
- *
- * @example
- * ```tsx
- * const loadMoreRef = useRef<HTMLDivElement>(null);
- *
- * useEffect(() => {
- *   if (!loadMoreRef.current) return;
- *   return createInfiniteScrollObserver(
- *     () => {
- *       if (hasNextPage && !isFetchingNextPage) {
- *         fetchNextPage();
- *       }
- *     },
- *     { root: scrollContainerRef.current }
- *   )(loadMoreRef.current);
- * }, [hasNextPage, isFetchingNextPage, fetchNextPage]);
- * ```
- */
-export function createInfiniteScrollObserver(
-  onIntersect: () => void,
-  options?: IntersectionObserverInit,
-): (element: Element) => () => void {
-  return (element: Element) => {
-    const observer = new IntersectionObserver((entries) => {
-      const [entry] = entries;
-      if (entry?.isIntersecting) {
-        onIntersect();
-      }
-    }, {
-      root: null,
-      rootMargin: "100px",
-      threshold: 0.1,
-      ...options,
-    });
-
-    observer.observe(element);
-
-    return () => {
-      observer.disconnect();
-    };
-  };
-}
+/**
+ * 游标分页工具函数
+ *
+ * 提供类型安全的游标分页支持，配合 react-query 的 useInfiniteQuery 使用。
+ *
+ * @module mtmsdk/supabase/cursor-pagination
+ */
+
+/**
+ * 游标类型定义
+ *
+ * 使用复合游标 (updated_at + id) 确保分页的唯一性和稳定性
+ */
+export interface CursorPagination {
+  cursor: string | null; // ISO 时间戳字符串, 如 "2026-01-20T08:00:00Z"
+  cursorId: string | null; // UUID 字符串
+}
+
+/**
+ * 从数据列表中提取下一页游标
+ *
+ * @param items - 当前页的数据列表
+ * @param limit - 每页数量
+ * @param cursorField - 游标字段名 (默认 "updated_at")
+ * @param idField - ID 字段名 (默认 "id")
+ * @returns 下一页游标, 如果没有更多数据则返回 undefined
+ *
+ * @example
+ * ```tsx
+ * const { data, fetchNextPage, hasNextPage } = useInfiniteQuery({
+ *   queryKey: ['projects', kw],
+ *   queryFn: async ({ pageParam }) => {
+ *     const { data } = await sb.rpc('audit_project_list_cursor', {
+ *       p_cursor: pageParam?.cursor ?? null,
+ *       p_cursor_id: pageParam?.cursorId ?? null,
+ *       p_limit: 20,
+ *       p_kw: kw
+ *     });
+ *     return data ?? [];
+ *   },
+ *   getNextPageParam: (lastPage) => getNextCursor(lastPage, 20),
+ *   initialPageParam: null as CursorPagination | null
+ * });
+ * ```
+ */
+export function getNextCursor<
+  T extends Record<string, unknown>,
+>(
+  items: T[] | null | undefined,
+  limit: number,
+  cursorField: keyof T = "updated_at" as keyof T,
+  idField: keyof T = "id" as keyof T,
+): CursorPagination | undefined {
+  // 如果数据为空或数量小于 limit，说明已到达最后一页
+  if (!items || items.length < limit) {
+    return undefined;
+  }
+
+  // 获取最后一条记录
+  const lastItem = items[items.length - 1];
+  if (!lastItem) {
+    return undefined;
+  }
+
+  const cursorValue = lastItem[cursorField];
+  const idValue = lastItem[idField];
+
+  // 验证游标值有效性
+  if (cursorValue === undefined || cursorValue === null) {
+    return undefined;
+  }
+
+  return {
+    cursor: String(cursorValue),
+    cursorId: idValue != null ? String(idValue) : null,
+  };
+}
+
+/**
+ * 将所有分页数据合并为单一列表
+ *
+ * @param pages - useInfiniteQuery 返回的 pages 数组
+ * @returns 合并后的扁平数据列表
+ *
+ * @example
+ * ```tsx
+ * const { data } = useInfiniteQuery({ ... });
+ * const allProjects = flattenPages(data?.pages);
+ * ```
+ */
+export function flattenPages<T>(
+  pages: T[][] | undefined,
+): T[] {
+  if (!pages) return [];
+  return pages.flat();
+}
+
+/**
+ * 无限滚动分页状态
+ */
+export interface InfiniteScrollState {
+  isLoading: boolean;
+  isFetchingNextPage: boolean;
+  hasNextPage: boolean;
+  error: Error | null;
+}
+
+/**
+ * 创建 IntersectionObserver 用于无限滚动
+ *
+ * @param onIntersect - 当元素进入视口时的回调
+ * @param options - IntersectionObserver 配置选项
+ * @returns cleanup 函数
+ *
+ * @example
+ * ```tsx
+ * const loadMoreRef = useRef<HTMLDivElement>(null);
+ *
+ * useEffect(() => {
+ *   if (!loadMoreRef.current) return;
+ *   return createInfiniteScrollObserver(
+ *     () => {
+ *       if (hasNextPage && !isFetchingNextPage) {
+ *         fetchNextPage();
+ *       }
+ *     },
+ *     { root: scrollContainerRef.current }
+ *   )(loadMoreRef.current);
+ * }, [hasNextPage, isFetchingNextPage, fetchNextPage]);
+ * ```
+ */
+export function createInfiniteScrollObserver(
+  onIntersect: () => void,
+  options?: IntersectionObserverInit,
+): (element: Element) => () => void {
+  return (element: Element) => {
+    const observer = new IntersectionObserver((entries) => {
+      const [entry] = entries;
+      if (entry?.isIntersecting) {
+        onIntersect();
+      }
+    }, {
+      root: null,
+      rootMargin: "100px",
+      threshold: 0.1,
+      ...options,
+    });
+
+    observer.observe(element);
+
+    return () => {
+      observer.disconnect();
+    };
+  };
+}

package/src/supabase/schema/browser.ts

@@ -1,45 +1,45 @@
-import z from "zod";
-
-export const zRpcBaseResponse = z.object({
-  error: z.object({
-    message: z.string(),
-  }),
-});
-export const zBrowserUpsertArgs = z
-  .object({
-    id: z.string().nullish(),//.transform( x => x ?? undefined ),
-    title: z.string(),
-    profile_id: z.string().nullish(),//.transform( x => x ?? undefined ),
-    description: z.string().nullish()//.transform( x => x ?? undefined ),
-  })
-  .meta({ ref: "BrowserUpsertArgs" });
-
-export const zBrowserListReq = z
-  .object({
-    kw: z.string().optional(),
-  })
-  .describe("BrowserListReq")
-  .meta({ ref: "BrowserListReq" });
-
-const zBrowserItem = z
-  .object({
-    id: z.string(),
-    title: z.string(),
-  })
-  .describe("BrowserItem")
-  .meta({ ref: "BrowserItem" });
-
-export const zBrowserData = z
-  .object({
-    id: z.string(),
-    title: z.string(),
-  })
-  .describe("BrowserData")
-  .meta({ ref: "BrowserData" });
-
-export const zBrowserListResponse = zRpcBaseResponse
-  .extend({
-    data: z.array(zBrowserItem),
-  })
-  // .describe("BrowserProfileResponse")
+import z from "zod";
+
+export const zRpcBaseResponse = z.object({
+  error: z.object({
+    message: z.string(),
+  }),
+});
+export const zBrowserUpsertArgs = z
+  .object({
+    id: z.string().nullish(),//.transform( x => x ?? undefined ),
+    title: z.string(),
+    profile_id: z.string().nullish(),//.transform( x => x ?? undefined ),
+    description: z.string().nullish()//.transform( x => x ?? undefined ),
+  })
+  .meta({ ref: "BrowserUpsertArgs" });
+
+export const zBrowserListReq = z
+  .object({
+    kw: z.string().optional(),
+  })
+  .describe("BrowserListReq")
+  .meta({ ref: "BrowserListReq" });
+
+const zBrowserItem = z
+  .object({
+    id: z.string(),
+    title: z.string(),
+  })
+  .describe("BrowserItem")
+  .meta({ ref: "BrowserItem" });
+
+export const zBrowserData = z
+  .object({
+    id: z.string(),
+    title: z.string(),
+  })
+  .describe("BrowserData")
+  .meta({ ref: "BrowserData" });
+
+export const zBrowserListResponse = zRpcBaseResponse
+  .extend({
+    data: z.array(zBrowserItem),
+  })
+  // .describe("BrowserProfileResponse")
   .meta({ ref: "BrowserList" });