@nextsparkjs/core 0.1.0-beta.8 → 0.1.0-beta.81

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAGA,cAAc,WAAW,CAAA;AACzB,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AACvC,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,0BAA0B,CAAA;AACxC,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAGA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,WAAW,CAAA;AACzB,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AACvC,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA"}

package/dist/hooks/index.js

@@ -1,39 +1,41 @@
-export * from "./useAuth";
-export * from "./useAuthMethodDetector";
-export * from "./useContentTranslation";
-export * from "./useContextAwareTranslations";
-export * from "./useDebounce";
-export * from "./useEnabledEntities";
-export * from "./useEnsureUserMetadata";
-export * from "./useEntity";
-export * from "./useEntityConfig";
-export * from "./useEntityMutations";
-export * from "./useEntityQuery";
-export * from "./useEntitySearch";
-export * from "./useEntityTranslations";
-export * from "./useEntityWithMeta";
-export * from "./useFeature";
-export * from "./useInvoice";
-export * from "./useInvoices";
-export * from "./useLastAuthMethod";
-export * from "./useLocale";
-export * from "./useMembership";
-export * from "./useNotifications";
-export * from "./useOrigin";
-export * from "./useQuickCreateEntities";
-export * from "./useQuota";
-export * from "./useSearch";
-export * from "./useSidebarState";
-export * from "./useSubscription";
-export * from "./useTeam";
-export * from "./useTeamInvitations";
-export * from "./useTeamMembers";
-export * from "./useTeams";
-export * from "./useTeamsConfig";
-export * from "./useToast";
-export * from "./useTranslationPreload";
-export * from "./useTreeNavigation";
-export * from "./useUrlFilters";
-export * from "./useUserProfile";
-export * from "./useUserSettings";
-export * from "./useValidationSchemas";
+export * from "./useApiExplorerNavigation.js";
+export * from "./useAuth.js";
+export * from "./useAuthMethodDetector.js";
+export * from "./useContentTranslation.js";
+export * from "./useContextAwareTranslations.js";
+export * from "./useDebounce.js";
+export * from "./useEnabledEntities.js";
+export * from "./useEnsureUserMetadata.js";
+export * from "./useEntity.js";
+export * from "./useEntityConfig.js";
+export * from "./useEntityMutations.js";
+export * from "./useEntityQuery.js";
+export * from "./useEntitySearch.js";
+export * from "./useEntityTranslations.js";
+export * from "./useEntityWithMeta.js";
+export * from "./useFeature.js";
+export * from "./useInvoice.js";
+export * from "./useInvoices.js";
+export * from "./useLastAuthMethod.js";
+export * from "./useLocale.js";
+export * from "./useMembership.js";
+export * from "./useNotifications.js";
+export * from "./useOrigin.js";
+export * from "./usePatternUsages.js";
+export * from "./useQuickCreateEntities.js";
+export * from "./useQuota.js";
+export * from "./useSearch.js";
+export * from "./useSidebarState.js";
+export * from "./useSubscription.js";
+export * from "./useTeam.js";
+export * from "./useTeamInvitations.js";
+export * from "./useTeamMembers.js";
+export * from "./useTeams.js";
+export * from "./useTeamsConfig.js";
+export * from "./useToast.js";
+export * from "./useTranslationPreload.js";
+export * from "./useTreeNavigation.js";
+export * from "./useUrlFilters.js";
+export * from "./useUserProfile.js";
+export * from "./useUserSettings.js";
+export * from "./useValidationSchemas.js";

package/dist/hooks/teams/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Teams Hooks
+ *
+ * React Query hooks for team management.
+ *
+ * @module core/hooks/teams
+ *
+ * @example
+ * ```tsx
+ * // User's teams (team switcher, forms)
+ * import { useUserTeams } from '@nextsparkjs/core/hooks/teams'
+ *
+ * // Admin teams management (superadmin page)
+ * import { useAdminTeams } from '@nextsparkjs/core/hooks/teams'
+ *
+ * // Searchable dropdown (API Explorer, filters)
+ * import { useTeamSearch } from '@nextsparkjs/core/hooks/teams'
+ * ```
+ */
+export { useUserTeams } from './useUserTeams';
+export { useAdminTeams } from './useAdminTeams';
+export { useTeamSearch } from './useTeamSearch';
+export type { UseUserTeamsReturn } from './useUserTeams';
+export type { UseAdminTeamsOptions, UseAdminTeamsReturn } from './useAdminTeams';
+export type { UseTeamSearchReturn } from './useTeamSearch';
+export type { Team, TeamWithOwner, AdminTeamsParams, AdminTeamsResponse, } from '../../lib/teams/types';
+export { teamsKeys } from '../../lib/teams/teams.keys';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/teams/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/teams/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAG/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACxD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAChF,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAG1D,YAAY,EACV,IAAI,EACJ,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/hooks/teams/index.js

@@ -0,0 +1,10 @@
+import { useUserTeams } from "./useUserTeams.js";
+import { useAdminTeams } from "./useAdminTeams.js";
+import { useTeamSearch } from "./useTeamSearch.js";
+import { teamsKeys } from "../../lib/teams/teams.keys.js";
+export {
+  teamsKeys,
+  useAdminTeams,
+  useTeamSearch,
+  useUserTeams
+};

package/dist/hooks/teams/useAdminTeams.d.ts

@@ -0,0 +1,82 @@
+import type { AdminTeamsParams } from '../../lib/teams/types';
+/**
+ * Options for useAdminTeams hook
+ */
+export interface UseAdminTeamsOptions extends AdminTeamsParams {
+    /** Whether the query should run (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Hook for fetching all teams (admin only)
+ *
+ * Requires superadmin or developer role.
+ * Supports search, type filtering, and pagination.
+ *
+ * For user's own teams, use useUserTeams instead.
+ * For optimized dropdown search, use useTeamSearch instead.
+ *
+ * @param options - Query parameters and options
+ *
+ * @example
+ * ```tsx
+ * // Superadmin teams management page
+ * function TeamsManagement() {
+ *   const [search, setSearch] = useState('')
+ *   const [type, setType] = useState<'user' | 'system'>('user')
+ *   const [page, setPage] = useState(1)
+ *
+ *   const { teams, counts, pagination, isLoading } = useAdminTeams({
+ *     search,
+ *     type,
+ *     page,
+ *     limit: 20,
+ *   })
+ *
+ *   return (
+ *     <div>
+ *       <SearchInput value={search} onChange={setSearch} />
+ *       <Tabs value={type} onChange={setType}>
+ *         <Tab value="user">User Teams ({counts?.user})</Tab>
+ *         <Tab value="system">System ({counts?.system})</Tab>
+ *       </Tabs>
+ *       <TeamsTable teams={teams} />
+ *       <Pagination {...pagination} onChange={setPage} />
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+export declare function useAdminTeams(options?: UseAdminTeamsOptions): {
+    /** List of teams */
+    teams: import(".").TeamWithOwner[];
+    /** Team counts by type */
+    counts: {
+        total: number;
+        user: number;
+        system: number;
+    };
+    /** Pagination info */
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasMore: boolean;
+    };
+    /** Request metadata */
+    metadata: {
+        requestedBy: string;
+        requestedAt: string;
+        source: string;
+    };
+    /** Loading state */
+    isLoading: boolean;
+    /** Fetching state (for refetches) */
+    isFetching: boolean;
+    /** Error if any */
+    error: Error;
+    /** Refetch teams */
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import(".").AdminTeamsResponse, Error>>;
+};
+export type UseAdminTeamsReturn = ReturnType<typeof useAdminTeams>;
+//# sourceMappingURL=useAdminTeams.d.ts.map

package/dist/hooks/teams/useAdminTeams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAdminTeams.d.ts","sourceRoot":"","sources":["../../../src/hooks/teams/useAdminTeams.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB;IAY5D,oBAAoB;;IAEpB,0BAA0B;;;;;;IAE1B,sBAAsB;;;;;;;;IAEtB,uBAAuB;;;;;;IAEvB,oBAAoB;;IAEpB,qCAAqC;;IAErC,mBAAmB;;IAEnB,oBAAoB;;EAGvB;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA"}

package/dist/hooks/teams/useAdminTeams.js

@@ -0,0 +1,37 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { TeamsAPI } from "../../lib/teams/teams.api.js";
+import { teamsKeys } from "../../lib/teams/teams.keys.js";
+function useAdminTeams(options = {}) {
+  var _a, _b, _c, _d;
+  const { enabled = true, ...params } = options;
+  const query = useQuery({
+    queryKey: teamsKeys.adminList(params),
+    queryFn: () => TeamsAPI.getAdminTeams(params),
+    enabled,
+    staleTime: 30 * 1e3,
+    // 30 seconds
+    retry: 2
+  });
+  return {
+    /** List of teams */
+    teams: ((_a = query.data) == null ? void 0 : _a.teams) ?? [],
+    /** Team counts by type */
+    counts: (_b = query.data) == null ? void 0 : _b.counts,
+    /** Pagination info */
+    pagination: (_c = query.data) == null ? void 0 : _c.pagination,
+    /** Request metadata */
+    metadata: (_d = query.data) == null ? void 0 : _d.metadata,
+    /** Loading state */
+    isLoading: query.isLoading,
+    /** Fetching state (for refetches) */
+    isFetching: query.isFetching,
+    /** Error if any */
+    error: query.error,
+    /** Refetch teams */
+    refetch: query.refetch
+  };
+}
+export {
+  useAdminTeams
+};

package/dist/hooks/teams/useTeamSearch.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Hook optimized for team search dropdowns
+ *
+ * Fetches all user teams (excludes system admin team) with search support.
+ * Returns up to 100 teams - suitable for dropdown/combobox use.
+ *
+ * For full pagination support, use useAdminTeams instead.
+ * For current user's teams only, use useUserTeams instead.
+ *
+ * @param search - Search term (filters by team name or owner email)
+ * @param enabled - Whether the query should run (default: true)
+ *
+ * @example
+ * ```tsx
+ * // Searchable team dropdown
+ * function TeamDropdown({ onSelect }) {
+ *   const [search, setSearch] = useState('')
+ *   const debouncedSearch = useDebounce(search, 300)
+ *
+ *   const { teams, totalCount, isLoading } = useTeamSearch(debouncedSearch)
+ *
+ *   return (
+ *     <Combobox>
+ *       <Input value={search} onChange={setSearch} />
+ *       {isLoading ? (
+ *         <Spinner />
+ *       ) : (
+ *         <ComboboxList>
+ *           {teams.map(team => (
+ *             <ComboboxItem
+ *               key={team.id}
+ *               onSelect={() => onSelect(team.id)}
+ *             >
+ *               {team.name} ({team.owner.name})
+ *             </ComboboxItem>
+ *           ))}
+ *         </ComboboxList>
+ *       )}
+ *       <p>{totalCount} teams available</p>
+ *     </Combobox>
+ *   )
+ * }
+ * ```
+ */
+export declare function useTeamSearch(search?: string, enabled?: boolean): {
+    /** List of teams matching search */
+    teams: import(".").TeamWithOwner[];
+    /** Total count of user teams */
+    totalCount: number;
+    /** Loading state */
+    isLoading: boolean;
+    /** Fetching state (for search updates) */
+    isFetching: boolean;
+    /** Error if any */
+    error: Error;
+};
+export type UseTeamSearchReturn = ReturnType<typeof useTeamSearch>;
+//# sourceMappingURL=useTeamSearch.d.ts.map

package/dist/hooks/teams/useTeamSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTeamSearch.d.ts","sourceRoot":"","sources":["../../../src/hooks/teams/useTeamSearch.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,MAAW,EAAE,OAAO,GAAE,OAAc;IActE,oCAAoC;;IAEpC,gCAAgC;;IAEhC,oBAAoB;;IAEpB,0CAA0C;;IAE1C,mBAAmB;;EAGtB;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA"}

package/dist/hooks/teams/useTeamSearch.js

@@ -0,0 +1,35 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { TeamsAPI } from "../../lib/teams/teams.api.js";
+import { teamsKeys } from "../../lib/teams/teams.keys.js";
+function useTeamSearch(search = "", enabled = true) {
+  var _a, _b, _c;
+  const query = useQuery({
+    queryKey: teamsKeys.adminSearch(search),
+    queryFn: () => TeamsAPI.getAdminTeams({
+      search: search || void 0,
+      type: "user",
+      // Exclude system admin team
+      limit: 100
+      // Enough for dropdown
+    }),
+    enabled,
+    staleTime: 30 * 1e3
+    // 30 seconds
+  });
+  return {
+    /** List of teams matching search */
+    teams: ((_a = query.data) == null ? void 0 : _a.teams) ?? [],
+    /** Total count of user teams */
+    totalCount: ((_c = (_b = query.data) == null ? void 0 : _b.counts) == null ? void 0 : _c.user) ?? 0,
+    /** Loading state */
+    isLoading: query.isLoading,
+    /** Fetching state (for search updates) */
+    isFetching: query.isFetching,
+    /** Error if any */
+    error: query.error
+  };
+}
+export {
+  useTeamSearch
+};

package/dist/hooks/teams/useUserTeams.d.ts

@@ -0,0 +1,44 @@
+import type { Team, CreateTeamRequest } from '../../lib/teams/types';
+/**
+ * Hook for managing current user's teams
+ *
+ * Fetches teams the user belongs to and provides team creation.
+ * For admin access to ALL teams, use useAdminTeams instead.
+ *
+ * @example
+ * ```tsx
+ * function TeamSwitcher() {
+ *   const { teams, isLoading, createTeam } = useUserTeams()
+ *
+ *   if (isLoading) return <Spinner />
+ *
+ *   return (
+ *     <Select>
+ *       {teams.map(team => (
+ *         <SelectItem key={team.id}>{team.name}</SelectItem>
+ *       ))}
+ *     </Select>
+ *   )
+ * }
+ * ```
+ */
+export declare function useUserTeams(): {
+    /** User's teams */
+    teams: Team[];
+    /** Loading state */
+    isLoading: boolean;
+    /** Error if any */
+    error: Error;
+    /** Refetch teams */
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<Team[], Error>>;
+    /** Create a new team */
+    createTeam: import("@tanstack/react-query").UseMutateFunction<Team, Error, CreateTeamRequest, unknown>;
+    /** Create a new team (async) */
+    createTeamAsync: import("@tanstack/react-query").UseMutateAsyncFunction<Team, Error, CreateTeamRequest, unknown>;
+    /** Team creation in progress */
+    isCreating: boolean;
+    /** Team creation error */
+    createError: Error;
+};
+export type UseUserTeamsReturn = ReturnType<typeof useUserTeams>;
+//# sourceMappingURL=useUserTeams.d.ts.map

package/dist/hooks/teams/useUserTeams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUserTeams.d.ts","sourceRoot":"","sources":["../../../src/hooks/teams/useUserTeams.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAEpE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY;IAoBxB,mBAAmB;;IAEnB,oBAAoB;;IAEpB,mBAAmB;;IAEnB,oBAAoB;;IAEpB,wBAAwB;;IAExB,gCAAgC;;IAEhC,gCAAgC;;IAEhC,0BAA0B;;EAG7B;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAA"}

package/dist/hooks/teams/useUserTeams.js

@@ -0,0 +1,41 @@
+"use client";
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { TeamsAPI } from "../../lib/teams/teams.api.js";
+import { teamsKeys } from "../../lib/teams/teams.keys.js";
+function useUserTeams() {
+  const queryClient = useQueryClient();
+  const query = useQuery({
+    queryKey: teamsKeys.user(),
+    queryFn: TeamsAPI.getUserTeams,
+    staleTime: 5 * 60 * 1e3
+    // 5 minutes
+  });
+  const createMutation = useMutation({
+    mutationFn: TeamsAPI.createTeam,
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: teamsKeys.user() });
+      queryClient.invalidateQueries({ queryKey: teamsKeys.admin() });
+    }
+  });
+  return {
+    /** User's teams */
+    teams: query.data ?? [],
+    /** Loading state */
+    isLoading: query.isLoading,
+    /** Error if any */
+    error: query.error,
+    /** Refetch teams */
+    refetch: query.refetch,
+    /** Create a new team */
+    createTeam: createMutation.mutate,
+    /** Create a new team (async) */
+    createTeamAsync: createMutation.mutateAsync,
+    /** Team creation in progress */
+    isCreating: createMutation.isPending,
+    /** Team creation error */
+    createError: createMutation.error
+  };
+}
+export {
+  useUserTeams
+};

package/dist/hooks/useApiExplorerNavigation.d.ts

@@ -0,0 +1,38 @@
+import type { HttpMethod } from '../components/devtools/api-tester/types';
+export interface UseApiExplorerNavigationOptions {
+    /** Base path that precedes the dynamic segments (e.g., '/devtools/api') */
+    basePath: string;
+    /** Optional callback when endpoint changes */
+    onEndpointChange?: (method: HttpMethod | null, path: string | null) => void;
+}
+export interface UseApiExplorerNavigationReturn {
+    /** Currently selected HTTP method */
+    selectedMethod: HttpMethod | null;
+    /** Currently selected API path (e.g., '/api/v1/customers') */
+    selectedPath: string | null;
+    /** Navigate to an endpoint */
+    navigateToEndpoint: (method: HttpMethod, path: string) => void;
+    /** Clear selection (navigate to base) */
+    clearSelection: () => void;
+}
+/**
+ * Hook for API Explorer navigation with URL synchronization
+ *
+ * Provides bidirectional sync between URL pathname and selected endpoint.
+ * URL format: {basePath}/{METHOD}/{path}
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   selectedMethod,
+ *   selectedPath,
+ *   navigateToEndpoint,
+ * } = useApiExplorerNavigation({ basePath: '/devtools/api' })
+ *
+ * // URL: /devtools/api/GET/api/v1/customers
+ * // selectedMethod: 'GET'
+ * // selectedPath: '/api/v1/customers'
+ * ```
+ */
+export declare function useApiExplorerNavigation(options: UseApiExplorerNavigationOptions): UseApiExplorerNavigationReturn;
+//# sourceMappingURL=useApiExplorerNavigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useApiExplorerNavigation.d.ts","sourceRoot":"","sources":["../../src/hooks/useApiExplorerNavigation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAA;AAEzE,MAAM,WAAW,+BAA+B;IAC9C,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAA;IAChB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;CAC5E;AAED,MAAM,WAAW,8BAA8B;IAC7C,qCAAqC;IACrC,cAAc,EAAE,UAAU,GAAG,IAAI,CAAA;IACjC,8DAA8D;IAC9D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,8BAA8B;IAC9B,kBAAkB,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9D,yCAAyC;IACzC,cAAc,EAAE,MAAM,IAAI,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,8BAA8B,CAwDhC"}

package/dist/hooks/useApiExplorerNavigation.js

@@ -0,0 +1,48 @@
+"use client";
+import { usePathname, useRouter } from "next/navigation";
+import { useMemo, useCallback, useEffect, useRef } from "react";
+function useApiExplorerNavigation(options) {
+  const { basePath, onEndpointChange } = options;
+  const pathname = usePathname();
+  const router = useRouter();
+  const prevPathnameRef = useRef(pathname);
+  const selectedEndpoint = useMemo(() => {
+    if (!pathname.startsWith(basePath)) return null;
+    const relativePath = pathname.slice(basePath.length).replace(/^\//, "");
+    if (!relativePath) return null;
+    const segments = relativePath.split("/");
+    if (segments.length < 2) return null;
+    const method = segments[0];
+    if (!["GET", "POST", "PATCH", "PUT", "DELETE", "OPTIONS"].includes(method)) {
+      return null;
+    }
+    const path = "/" + segments.slice(1).join("/");
+    return { method, path };
+  }, [pathname, basePath]);
+  useEffect(() => {
+    if (prevPathnameRef.current !== pathname) {
+      prevPathnameRef.current = pathname;
+      onEndpointChange == null ? void 0 : onEndpointChange((selectedEndpoint == null ? void 0 : selectedEndpoint.method) || null, (selectedEndpoint == null ? void 0 : selectedEndpoint.path) || null);
+    }
+  }, [pathname, selectedEndpoint, onEndpointChange]);
+  const navigateToEndpoint = useCallback(
+    (method, path) => {
+      const pathSegments = path.replace(/^\//, "");
+      const newUrl = `${basePath}/${method}/${pathSegments}`;
+      router.push(newUrl);
+    },
+    [basePath, router]
+  );
+  const clearSelection = useCallback(() => {
+    router.push(basePath);
+  }, [basePath, router]);
+  return {
+    selectedMethod: (selectedEndpoint == null ? void 0 : selectedEndpoint.method) || null,
+    selectedPath: (selectedEndpoint == null ? void 0 : selectedEndpoint.path) || null,
+    navigateToEndpoint,
+    clearSelection
+  };
+}
+export {
+  useApiExplorerNavigation
+};

package/dist/hooks/useAuth.js

@@ -1,8 +1,8 @@
 "use client";
 import { useRouter } from "next/navigation";
-import { authClient } from "../lib/auth-client";
-import { useOrigin } from "./useOrigin";
-import { useLastAuthMethod } from "./useLastAuthMethod";
+import { authClient } from "../lib/auth-client.js";
+import { useOrigin } from "./useOrigin.js";
+import { useLastAuthMethod } from "./useLastAuthMethod.js";
 function useAuth() {
   var _a;
   const router = useRouter();

package/dist/hooks/useAuthMethodDetector.js

@@ -1,7 +1,7 @@
 "use client";
 import { useEffect } from "react";
 import { useSearchParams } from "next/navigation";
-import { useLastAuthMethod } from "./useLastAuthMethod";
+import { useLastAuthMethod } from "./useLastAuthMethod.js";
 function useAuthMethodDetector() {
   const searchParams = useSearchParams();
   const { saveAuthMethod } = useLastAuthMethod();

package/dist/hooks/useContextAwareTranslations.js

@@ -5,7 +5,7 @@ import { useLocale } from "next-intl";
 const CONTEXT_NAMESPACES = {
   public: ["common", "public", "auth"],
   auth: ["common", "auth", "validation"],
-  dashboard: ["common", "dashboard", "settings", "public", "teams"]
+  dashboard: ["common", "dashboard", "settings", "public", "teams", "admin"]
 };
 function useContextAwareTranslations() {
   const pathname = usePathname();

package/dist/hooks/useEnabledEntities.js

@@ -1,6 +1,6 @@
 "use client";
 import { useState, useEffect, useMemo } from "react";
-import { getEnabledEntities } from "../lib/entities/registry.client";
+import { getEnabledEntities } from "../lib/entities/registry.client.js";
 function useEnabledEntities() {
   const [entities, setEntities] = useState([]);
   const [isLoading, setIsLoading] = useState(true);

package/dist/hooks/useEnsureUserMetadata.js

@@ -1,6 +1,6 @@
 "use client";
 import { useEffect } from "react";
-import { authClient } from "../lib/auth-client";
+import { authClient } from "../lib/auth-client.js";
 function useEnsureUserMetadata() {
   var _a, _b;
   const session = authClient.useSession();

package/dist/hooks/useEntity.js

@@ -1,7 +1,7 @@
 "use client";
 import { useState, useCallback } from "react";
-import { useEntityQuery } from "./useEntityQuery";
-import { useEntityMutations } from "./useEntityMutations";
+import { useEntityQuery } from "./useEntityQuery.js";
+import { useEntityMutations } from "./useEntityMutations.js";
 function useEntity(options) {
   const {
     entityConfig,

package/dist/hooks/useEntityConfig.js

@@ -1,5 +1,5 @@
 import { useState, useEffect, useCallback } from "react";
-import { getAllEntityConfigs } from "../lib/entities/registry.client";
+import { getAllEntityConfigs } from "../lib/entities/registry.client.js";
 const configCache = /* @__PURE__ */ new Map();
 let registryLoaded = false;
 function useEntityConfig(entityType, options = {}) {

package/dist/hooks/useEntityMutations.js

@@ -1,6 +1,6 @@
 "use client";
 import { useMutation, useQueryClient } from "@tanstack/react-query";
-import { useAuth } from "./useAuth";
+import { useAuth } from "./useAuth.js";
 function useEntityMutations(options) {
   const { entityConfig, onSuccess, onError } = options;
   const { user } = useAuth();

package/dist/hooks/useEntityQuery.js

@@ -1,6 +1,6 @@
 "use client";
 import { useQuery } from "@tanstack/react-query";
-import { useAuth } from "./useAuth";
+import { useAuth } from "./useAuth.js";
 function useEntityQuery(options) {
   var _a, _b, _c;
   const {

package/dist/hooks/useEntitySearch.js

@@ -1,8 +1,8 @@
 "use client";
 import { useState, useEffect, useMemo, useCallback } from "react";
-import { useAuth } from "./useAuth";
-import { extractUserPlanData } from "../lib/user-data-utils";
-import { getEnabledEntities } from "../lib/entities/registry.client";
+import { useAuth } from "./useAuth.js";
+import { extractUserPlanData } from "../lib/user-data-utils.js";
+import { getEnabledEntities } from "../lib/entities/registry.client.js";
 function useEntitySearch() {
   const [query, setQuery] = useState("");
   const [isSearching, setIsSearching] = useState(false);