@nextsparkjs/core 0.1.0-beta.67 → 0.1.0-beta.69

package/dist/contexts/TeamContext.js

@@ -1,74 +1,94 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { createContext, useContext, useState, useEffect, useCallback } from "react";
+import { createContext, useContext, useState, useEffect, useCallback, useMemo } from "react";
 import { useRouter } from "next/navigation";
-import { useQueryClient } from "@tanstack/react-query";
+import { useQuery, useQueryClient } from "@tanstack/react-query";
 import { useAuth } from "../hooks/useAuth.js";
 import { TeamSwitchModal } from "../components/teams/TeamSwitchModal.js";
 import { APP_CONFIG_MERGED } from "../lib/config/config-sync.js";
 import { canUserCreateTeam } from "../lib/teams/helpers.js";
 const TeamContext = createContext(void 0);
+const TEAMS_QUERY_KEY = ["user-teams"];
+async function fetchUserTeams() {
+  const response = await fetch("/api/v1/teams");
+  const data = await response.json();
+  if (!response.ok || !data.data) {
+    throw new Error("Failed to fetch teams");
+  }
+  return data.data.map((t) => ({
+    team: {
+      id: t.id,
+      name: t.name,
+      slug: t.slug,
+      description: t.description,
+      ownerId: t.owner_id || t.ownerId,
+      avatarUrl: t.avatar_url || t.avatarUrl,
+      settings: t.settings || {},
+      createdAt: t.created_at || t.createdAt,
+      updatedAt: t.updated_at || t.updatedAt
+    },
+    role: t.userRole || t.user_role || t.role,
+    joinedAt: t.joinedAt || t.joined_at
+  }));
+}
 function TeamProvider({ children }) {
-  const { user } = useAuth();
+  const { user, isLoading: authLoading } = useAuth();
   const router = useRouter();
   const queryClient = useQueryClient();
   const [currentTeam, setCurrentTeam] = useState(null);
-  const [userTeams, setUserTeams] = useState([]);
-  const [isLoading, setIsLoading] = useState(true);
   const [isSwitching, setIsSwitching] = useState(false);
-  const [canCurrentUserCreateTeam, setCanCurrentUserCreateTeam] = useState(true);
+  const [initialSyncDone, setInitialSyncDone] = useState(false);
   const [switchModalOpen, setSwitchModalOpen] = useState(false);
   const [previousTeam, setPreviousTeam] = useState(null);
   const [targetTeam, setTargetTeam] = useState(null);
-  const loadUserTeams = useCallback(async () => {
+  const {
+    data: userTeams = [],
+    isLoading: teamsLoading,
+    refetch: refetchTeams
+  } = useQuery({
+    queryKey: TEAMS_QUERY_KEY,
+    queryFn: fetchUserTeams,
+    enabled: !!user && !authLoading,
+    staleTime: 1e3 * 60 * 5,
+    // Cache for 5 minutes - prevents refetch on navigation
+    gcTime: 1e3 * 60 * 60,
+    // Keep in cache for 1 hour
+    refetchOnWindowFocus: false,
+    // Don't refetch when window regains focus
+    refetchOnMount: false
+    // Don't refetch if data exists and is not stale
+  });
+  const isLoading = authLoading || teamsLoading;
+  const canCurrentUserCreateTeam = useMemo(() => {
+    if (!user || !userTeams.length) return false;
+    const { mode, options } = APP_CONFIG_MERGED.teams;
+    const ownedTeamsCount = userTeams.filter((m) => m.role === "owner").length;
+    return canUserCreateTeam(mode, options || {}, ownedTeamsCount);
+  }, [userTeams, user]);
+  useEffect(() => {
+    if (!userTeams.length || initialSyncDone) return;
+    const storedTeamId = typeof window !== "undefined" ? localStorage.getItem("activeTeamId") : null;
+    const storedTeam = userTeams.find((t) => t.team.id === storedTeamId);
+    const activeTeam = storedTeam || userTeams[0];
+    if (activeTeam) {
+      setCurrentTeam(activeTeam.team);
+      if (typeof window !== "undefined" && storedTeamId !== activeTeam.team.id) {
+        localStorage.setItem("activeTeamId", activeTeam.team.id);
+      }
+      if (typeof window !== "undefined") {
+        fetch("/api/v1/teams/switch", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ teamId: activeTeam.team.id })
+        }).catch((err) => console.error("Failed to sync team cookie:", err));
+      }
+      setInitialSyncDone(true);
+    }
+  }, [userTeams, initialSyncDone]);
+  useEffect(() => {
     if (!user) {
-      setUserTeams([]);
       setCurrentTeam(null);
-      setIsLoading(false);
-      return;
-    }
-    try {
-      setIsLoading(true);
-      const response = await fetch("/api/v1/teams");
-      const data = await response.json();
-      if (response.ok && data.data) {
-        const teams = data.data.map((t) => ({
-          team: {
-            id: t.id,
-            name: t.name,
-            slug: t.slug,
-            description: t.description,
-            ownerId: t.owner_id || t.ownerId,
-            avatarUrl: t.avatar_url || t.avatarUrl,
-            settings: t.settings || {},
-            createdAt: t.created_at || t.createdAt,
-            updatedAt: t.updated_at || t.updatedAt
-          },
-          role: t.userRole || t.user_role || t.role,
-          joinedAt: t.joinedAt || t.joined_at
-        }));
-        setUserTeams(teams);
-        const storedTeamId = typeof window !== "undefined" ? localStorage.getItem("activeTeamId") : null;
-        const storedTeam = teams.find((t) => t.team.id === storedTeamId);
-        const activeTeam = storedTeam || teams[0];
-        if (activeTeam) {
-          setCurrentTeam(activeTeam.team);
-          if (typeof window !== "undefined" && storedTeamId !== activeTeam.team.id) {
-            localStorage.setItem("activeTeamId", activeTeam.team.id);
-          }
-          if (typeof window !== "undefined") {
-            fetch("/api/v1/teams/switch", {
-              method: "POST",
-              headers: { "Content-Type": "application/json" },
-              body: JSON.stringify({ teamId: activeTeam.team.id })
-            }).catch((err) => console.error("Failed to sync team cookie:", err));
-          }
-        }
-      }
-    } catch (error) {
-      console.error("Failed to load teams:", error);
-    } finally {
-      setIsLoading(false);
+      setInitialSyncDone(false);
     }
   }, [user]);
   const handleSwitchComplete = useCallback(() => {
@@ -109,21 +129,9 @@ function TeamProvider({ children }) {
     }
   }, [userTeams, currentTeam]);
   const refreshTeams = useCallback(async () => {
-    await loadUserTeams();
-  }, [loadUserTeams]);
-  useEffect(() => {
-    loadUserTeams();
-  }, [loadUserTeams]);
-  useEffect(() => {
-    if (!user || !userTeams) {
-      setCanCurrentUserCreateTeam(false);
-      return;
-    }
-    const { mode, options } = APP_CONFIG_MERGED.teams;
-    const ownedTeamsCount = userTeams.filter((m) => m.role === "owner").length;
-    const canCreate = canUserCreateTeam(mode, options || {}, ownedTeamsCount);
-    setCanCurrentUserCreateTeam(canCreate);
-  }, [userTeams, user]);
+    await queryClient.invalidateQueries({ queryKey: TEAMS_QUERY_KEY });
+    await refetchTeams();
+  }, [queryClient, refetchTeams]);
   return /* @__PURE__ */ jsxs(
     TeamContext.Provider,
     {
@@ -159,6 +167,8 @@ function useTeamContext() {
   return context;
 }
 export {
+  TEAMS_QUERY_KEY,
   TeamProvider,
+  fetchUserTeams,
   useTeamContext
 };

package/dist/hooks/usePrefetch.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Hook to prefetch settings page data on hover
+ *
+ * @example
+ * ```tsx
+ * function SettingsSidebar() {
+ *   const { prefetchProfile, prefetchTeams } = usePrefetchSettings()
+ *
+ *   return (
+ *     <nav>
+ *       <Link href="/dashboard/settings/profile" onMouseEnter={prefetchProfile}>
+ *         Profile
+ *       </Link>
+ *       <Link href="/dashboard/settings/teams" onMouseEnter={prefetchTeams}>
+ *         Teams
+ *       </Link>
+ *     </nav>
+ *   )
+ * }
+ * ```
+ */
+export declare function usePrefetchSettings(): {
+    prefetchProfile: () => void;
+    prefetchTeams: () => void;
+};
+/**
+ * Generic prefetch hook for any entity list
+ *
+ * @example
+ * ```tsx
+ * function EntityNav() {
+ *   const prefetchProducts = usePrefetchEntity('products')
+ *
+ *   return (
+ *     <Link href="/dashboard/products" onMouseEnter={prefetchProducts}>
+ *       Products
+ *     </Link>
+ *   )
+ * }
+ * ```
+ */
+export declare function usePrefetchEntity(entitySlug: string): () => void;
+//# sourceMappingURL=usePrefetch.d.ts.map

package/dist/hooks/usePrefetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePrefetch.d.ts","sourceRoot":"","sources":["../../src/hooks/usePrefetch.ts"],"names":[],"mappings":"AAyBA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB;;;EAuBlC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,cAgBnD"}

package/dist/hooks/usePrefetch.js

@@ -0,0 +1,56 @@
+"use client";
+import { useQueryClient } from "@tanstack/react-query";
+import { useCallback } from "react";
+import { TEAMS_QUERY_KEY, fetchUserTeams } from "../contexts/TeamContext.js";
+const USER_PROFILE_QUERY_KEY = ["user-profile"];
+async function fetchUserProfile() {
+  const response = await fetch("/api/user/profile");
+  if (!response.ok) {
+    throw new Error("Failed to fetch profile");
+  }
+  return response.json();
+}
+function usePrefetchSettings() {
+  const queryClient = useQueryClient();
+  const prefetchProfile = useCallback(() => {
+    queryClient.prefetchQuery({
+      queryKey: USER_PROFILE_QUERY_KEY,
+      queryFn: fetchUserProfile,
+      staleTime: 1e3 * 60 * 5
+      // 5 minutes
+    });
+  }, [queryClient]);
+  const prefetchTeams = useCallback(() => {
+    queryClient.prefetchQuery({
+      queryKey: TEAMS_QUERY_KEY,
+      queryFn: fetchUserTeams,
+      staleTime: 1e3 * 60 * 5
+      // 5 minutes
+    });
+  }, [queryClient]);
+  return {
+    prefetchProfile,
+    prefetchTeams
+  };
+}
+function usePrefetchEntity(entitySlug) {
+  const queryClient = useQueryClient();
+  return useCallback(() => {
+    queryClient.prefetchQuery({
+      queryKey: ["entity", entitySlug, "list"],
+      queryFn: async () => {
+        const response = await fetch(`/api/v1/${entitySlug}?limit=20`);
+        if (!response.ok) {
+          throw new Error(`Failed to fetch ${entitySlug}`);
+        }
+        return response.json();
+      },
+      staleTime: 1e3 * 60 * 2
+      // 2 minutes for entity lists
+    });
+  }, [queryClient, entitySlug]);
+}
+export {
+  usePrefetchEntity,
+  usePrefetchSettings
+};

package/dist/lib/actions/index.d.ts

@@ -1,7 +1,7 @@
 /**
- * Entity Server Actions
+ * NextSpark Server Actions
  *
- * Generic Server Actions for CRUD operations on any registered entity.
+ * Server Actions for CRUD operations, user management, and team management.
  * Auth (userId/teamId) is obtained automatically from session and cookies.
  *
  * Import from '@nextsparkjs/core/actions' or '@nextsparkjs/core/lib/actions'.
@@ -9,31 +9,44 @@
  * @example
  * ```typescript
  * import {
+ *   // Entity actions
  *   createEntity,
  *   updateEntity,
  *   deleteEntity,
  *   getEntity,
  *   listEntities,
+ *   // User actions
+ *   updateProfile,
+ *   updateAvatar,
+ *   deleteAccount,
+ *   // Team actions
+ *   updateTeam,
+ *   inviteMember,
+ *   removeMember,
+ *   updateMemberRole,
  * } from '@nextsparkjs/core/actions'
  *
- * // Create - auth obtained from server session
+ * // Entity operations - auth obtained from server session
  * const result = await createEntity('schools', { name: 'MIT' })
- *
- * // Update with revalidation
- * await updateEntity('campaigns', id, { status: 'paused' }, {
- *   revalidatePaths: ['/dashboard']
- * })
- *
- * // Delete with redirect
+ * await updateEntity('campaigns', id, { status: 'paused' })
  * await deleteEntity('leads', id, { redirectTo: '/leads' })
  *
- * // Get by ID
- * const entity = await getEntity('schools', id)
+ * // User profile operations
+ * await updateProfile({ firstName: 'John', lastName: 'Doe' })
+ * await updateAvatar(formData)
+ * await deleteAccount()
  *
- * // List with filters
- * const list = await listEntities('campaigns', { limit: 20, where: { status: 'active' } })
+ * // Team operations
+ * await updateTeam('team-id', { name: 'New Name' })
+ * await inviteMember('team-id', 'user@example.com', 'member')
+ * await removeMember('team-id', 'member-id')
+ * await updateMemberRole('team-id', 'member-id', 'admin')
  * ```
  */
 export { createEntity, updateEntity, deleteEntity, getEntity, listEntities, deleteEntities, entityExists, countEntities, } from './entity.actions';
+export { updateProfile, updateAvatar, deleteAccount, } from './user.actions';
+export type { UpdateProfileData, ProfileUpdateResult, } from './user.actions';
+export { updateTeam, inviteMember, removeMember, updateMemberRole, } from './team.actions';
+export type { UpdateTeamData, InviteMemberResult, } from './team.actions';
 export type { EntityActionResult, EntityActionVoidResult, CreateEntityInput, UpdateEntityInput, ListEntityOptions, ListEntityResult, ActionConfig, ActionAuthContext, BatchDeleteResult, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/actions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/actions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAGH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,GACd,MAAM,kBAAkB,CAAA;AAGzB,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/actions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAMH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,GACd,MAAM,kBAAkB,CAAA;AAMzB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,gBAAgB,CAAA;AAMvB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,gBAAgB,GACjB,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,cAAc,EACd,kBAAkB,GACnB,MAAM,gBAAgB,CAAA;AAMvB,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,SAAS,CAAA"}

package/dist/lib/actions/index.js

@@ -8,13 +8,31 @@ import {
   entityExists,
   countEntities
 } from "./entity.actions.js";
+import {
+  updateProfile,
+  updateAvatar,
+  deleteAccount
+} from "./user.actions.js";
+import {
+  updateTeam,
+  inviteMember,
+  removeMember,
+  updateMemberRole
+} from "./team.actions.js";
 export {
   countEntities,
   createEntity,
+  deleteAccount,
   deleteEntities,
   deleteEntity,
   entityExists,
   getEntity,
+  inviteMember,
   listEntities,
-  updateEntity
+  removeMember,
+  updateAvatar,
+  updateEntity,
+  updateMemberRole,
+  updateProfile,
+  updateTeam
 };

package/dist/lib/actions/team.actions.d.ts

@@ -0,0 +1,107 @@
+import type { Team, TeamRole, TeamMember } from '../teams/types';
+import type { EntityActionResult, EntityActionVoidResult } from './types';
+/**
+ * Team update data that can be passed to updateTeam
+ */
+export interface UpdateTeamData {
+    name?: string;
+    slug?: string;
+    description?: string;
+    avatarUrl?: string;
+    settings?: Record<string, unknown>;
+}
+/**
+ * Result of invite member action
+ */
+export interface InviteMemberResult {
+    memberId: string;
+    userId: string;
+    teamId: string;
+    role: TeamRole;
+}
+/**
+ * Update a team's information
+ *
+ * Requires owner or admin role in the team.
+ *
+ * @param teamId - The team ID to update
+ * @param data - Team fields to update
+ * @returns Updated team data wrapped in EntityActionResult
+ *
+ * @example
+ * ```typescript
+ * const result = await updateTeam('team-123', {
+ *   name: 'New Team Name',
+ *   description: 'Updated description'
+ * })
+ *
+ * if (result.success) {
+ *   console.log('Team updated:', result.data.name)
+ * }
+ * ```
+ */
+export declare function updateTeam(teamId: string, data: UpdateTeamData): Promise<EntityActionResult<Team>>;
+/**
+ * Invite a user to join the team
+ *
+ * Requires owner or admin role in the team.
+ * The user must already exist in the system.
+ *
+ * @param teamId - The team ID
+ * @param email - Email of the user to invite
+ * @param role - Role to assign (member, admin, viewer)
+ * @returns Created membership data wrapped in EntityActionResult
+ *
+ * @example
+ * ```typescript
+ * const result = await inviteMember('team-123', 'user@example.com', 'member')
+ *
+ * if (result.success) {
+ *   console.log('Member invited:', result.data.memberId)
+ * }
+ * ```
+ */
+export declare function inviteMember(teamId: string, email: string, role?: TeamRole): Promise<EntityActionResult<InviteMemberResult>>;
+/**
+ * Remove a member from the team
+ *
+ * Requires owner or admin role in the team.
+ * Cannot remove the team owner (must transfer ownership first).
+ *
+ * @param teamId - The team ID
+ * @param memberId - The member ID to remove (from team_members table)
+ * @returns Success status
+ *
+ * @example
+ * ```typescript
+ * const result = await removeMember('team-123', 'member-id-456')
+ *
+ * if (result.success) {
+ *   console.log('Member removed')
+ * }
+ * ```
+ */
+export declare function removeMember(teamId: string, memberId: string): Promise<EntityActionVoidResult>;
+/**
+ * Update a team member's role
+ *
+ * Requires owner role to change to/from admin.
+ * Admins can change member/viewer roles.
+ * Cannot change owner role (must transfer ownership).
+ *
+ * @param teamId - The team ID
+ * @param memberId - The member's user ID
+ * @param role - New role to assign
+ * @returns Updated membership data wrapped in EntityActionResult
+ *
+ * @example
+ * ```typescript
+ * const result = await updateMemberRole('team-123', 'user-456', 'admin')
+ *
+ * if (result.success) {
+ *   console.log('Role updated:', result.data.role)
+ * }
+ * ```
+ */
+export declare function updateMemberRole(teamId: string, memberId: string, role: TeamRole): Promise<EntityActionResult<TeamMember>>;
+//# sourceMappingURL=team.actions.d.ts.map

package/dist/lib/actions/team.actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.actions.d.ts","sourceRoot":"","sources":["../../../src/lib/actions/team.actions.ts"],"names":[],"mappings":"AA4CA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAMzE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,QAAQ,CAAA;CACf;AAgDD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CA4DnC;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,QAAmB,GACxB,OAAO,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAqEjD;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,CAAC,CAgEjC;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAsEzC"}