@beeuni/sdk 0.1.0

package/dist/react/use-admin-analytics.d.ts

@@ -0,0 +1,331 @@
+export type AnalyticsSource = 'vercel' | 'ga';
+export interface AnalyticsSummary {
+    total_users: number;
+    total_threads: number;
+    active_users_week: number;
+    new_signups_today: number;
+    new_signups_week: number;
+    conversion_rate_week: number;
+    avg_threads_per_user: number;
+}
+export interface ThreadAnalytics {
+    thread_id: string;
+    project_id?: string | null;
+    project_name?: string | null;
+    project_category?: string | null;
+    account_id: string;
+    user_email?: string | null;
+    message_count: number;
+    user_message_count: number;
+    first_user_message?: string | null;
+    first_message_summary?: string | null;
+    created_at: string;
+    updated_at: string;
+    is_public: boolean;
+}
+export interface RetentionData {
+    user_id: string;
+    email?: string | null;
+    first_activity: string;
+    last_activity: string;
+    total_threads: number;
+    weeks_active: number;
+    is_recurring: boolean;
+}
+export interface MessageDistribution {
+    distribution: {
+        '0_messages': number;
+        '1_message': number;
+        '2_3_messages': number;
+        '5_plus_messages': number;
+    };
+    total_threads: number;
+}
+export interface CategoryDistribution {
+    distribution: Record<string, number>;
+    total_projects: number;
+    date: string;
+}
+export interface TierDistribution {
+    distribution: Record<string, number>;
+    total_threads: number;
+    date: string;
+}
+export interface VisitorStats {
+    total_visitors: number;
+    unique_visitors: number;
+    pageviews: number;
+    date: string;
+}
+export interface ConversionFunnel {
+    visitors: number;
+    signups: number;
+    subscriptions: number;
+    web_subscriber_emails: string[];
+    app_subscriber_emails: string[];
+    visitor_to_signup_rate: number;
+    signup_to_subscription_rate: number;
+    overall_conversion_rate: number;
+    date: string;
+}
+export interface TranslationResponse {
+    original: string;
+    translated: string;
+    target_language: string;
+}
+interface PaginationMeta {
+    current_page: number;
+    page_size: number;
+    total_items: number;
+    total_pages: number;
+    has_next: boolean;
+    has_previous: boolean;
+}
+interface PaginatedResponse<T> {
+    data: T[];
+    pagination: PaginationMeta;
+}
+export interface ThreadBrowseParams {
+    page?: number;
+    page_size?: number;
+    min_messages?: number;
+    max_messages?: number;
+    search_email?: string;
+    category?: string;
+    tier?: string;
+    date_from?: string;
+    date_to?: string;
+    sort_by?: string;
+    sort_order?: 'asc' | 'desc';
+}
+export interface RetentionParams {
+    page?: number;
+    page_size?: number;
+    weeks_back?: number;
+    min_weeks_active?: number;
+}
+export declare function useAnalyticsSummary(): import("@tanstack/react-query").UseQueryResult<AnalyticsSummary, Error>;
+export declare function useThreadBrowser(params?: ThreadBrowseParams): import("@tanstack/react-query").UseQueryResult<PaginatedResponse<ThreadAnalytics>, Error>;
+export declare function useMessageDistribution(dateFrom?: string, dateTo?: string, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<MessageDistribution, Error>;
+export declare function useCategoryDistribution(dateFrom?: string, dateTo?: string, tier?: string | null, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<CategoryDistribution, Error>;
+export declare function useTierDistribution(dateFrom?: string, dateTo?: string, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<TierDistribution, Error>;
+export declare function useVisitorStats(date?: string, source?: AnalyticsSource): import("@tanstack/react-query").UseQueryResult<VisitorStats, Error>;
+export declare function useConversionFunnel(dateFrom?: string, dateTo?: string, source?: AnalyticsSource): import("@tanstack/react-query").UseQueryResult<ConversionFunnel, Error>;
+export declare function useRetentionData(params?: RetentionParams): import("@tanstack/react-query").UseQueryResult<PaginatedResponse<RetentionData>, Error>;
+export declare function useTranslate(): import("@tanstack/react-query").UseMutationResult<TranslationResponse, Error, {
+    text: string;
+    targetLanguage?: string;
+}>;
+export interface FieldOverrides {
+    views?: boolean;
+    signups?: boolean;
+    new_paid?: boolean;
+    churn?: boolean;
+    subscribers?: boolean;
+    mrr?: boolean;
+    arr?: boolean;
+}
+export type Platform = 'web' | 'app';
+export interface WeeklyActualData {
+    week_number: number;
+    week_start_date: string;
+    platform: Platform;
+    views: number;
+    signups: number;
+    new_paid: number;
+    churn: number;
+    subscribers: number;
+    mrr: number;
+    arr: number;
+    overrides?: FieldOverrides;
+}
+export interface WeeklyActualsResponse {
+    actuals: Record<string, WeeklyActualData>;
+}
+export declare function useARRWeeklyActuals(): import("@tanstack/react-query").UseQueryResult<WeeklyActualsResponse, Error>;
+export declare function useUpdateARRWeeklyActual(): import("@tanstack/react-query").UseMutationResult<WeeklyActualData, Error, WeeklyActualData>;
+export interface DeleteWeeklyActualParams {
+    weekNumber: number;
+    platform: Platform;
+}
+export declare function useDeleteARRWeeklyActual(): import("@tanstack/react-query").UseMutationResult<{
+    message: string;
+}, Error, DeleteWeeklyActualParams>;
+export interface ToggleOverrideParams {
+    weekNumber: number;
+    platform: Platform;
+    field: keyof FieldOverrides;
+    override: boolean;
+}
+export declare function useToggleFieldOverride(): import("@tanstack/react-query").UseMutationResult<{
+    message: string;
+}, Error, ToggleOverrideParams>;
+export interface SimulatorConfigData {
+    starting_subs: number;
+    starting_mrr: number;
+    weekly_visitors: number;
+    landing_conversion: number;
+    signup_to_paid: number;
+    arpu: number;
+    monthly_churn: number;
+    visitor_growth: number;
+    target_arr: number;
+}
+export declare function useARRSimulatorConfig(): import("@tanstack/react-query").UseQueryResult<SimulatorConfigData, Error>;
+export declare function useUpdateARRSimulatorConfig(): import("@tanstack/react-query").UseMutationResult<SimulatorConfigData, Error, SimulatorConfigData>;
+export interface SignupsByDateResponse {
+    date_from: string;
+    date_to: string;
+    signups_by_date: Record<string, number>;
+    total: number;
+}
+export declare function useSignupsByDate(dateFrom: string, dateTo: string): import("@tanstack/react-query").UseQueryResult<SignupsByDateResponse, Error>;
+export interface ViewsByDateResponse {
+    date_from: string;
+    date_to: string;
+    views_by_date: Record<string, number>;
+    total: number;
+}
+export declare function useViewsByDate(dateFrom: string, dateTo: string, source?: AnalyticsSource): import("@tanstack/react-query").UseQueryResult<ViewsByDateResponse, Error>;
+export interface NewPaidByDateResponse {
+    date_from: string;
+    date_to: string;
+    new_paid_by_date: Record<string, number>;
+    total: number;
+}
+export declare function useNewPaidByDate(dateFrom: string, dateTo: string): import("@tanstack/react-query").UseQueryResult<NewPaidByDateResponse, Error>;
+export interface ChurnByDateResponse {
+    date_from: string;
+    date_to: string;
+    churn_by_date: Record<string, number>;
+    total: number;
+}
+export declare function useChurnByDate(dateFrom: string, dateTo: string): import("@tanstack/react-query").UseQueryResult<ChurnByDateResponse, Error>;
+export interface MonthlyActualData {
+    month_index: number;
+    month_name: string;
+    platform: Platform;
+    views: number;
+    signups: number;
+    new_paid: number;
+    churn: number;
+    subscribers: number;
+    mrr: number;
+    arr: number;
+    overrides?: FieldOverrides;
+}
+export interface MonthlyActualsResponse {
+    actuals: Record<string, MonthlyActualData>;
+}
+export declare function useARRMonthlyActuals(): import("@tanstack/react-query").UseQueryResult<MonthlyActualsResponse, Error>;
+export declare function useUpdateARRMonthlyActual(): import("@tanstack/react-query").UseMutationResult<MonthlyActualData, Error, MonthlyActualData>;
+export interface DeleteMonthlyActualParams {
+    monthIndex: number;
+    platform: Platform;
+}
+export declare function useDeleteARRMonthlyActual(): import("@tanstack/react-query").UseMutationResult<{
+    message: string;
+}, Error, DeleteMonthlyActualParams>;
+export interface ToggleMonthlyOverrideParams {
+    monthIndex: number;
+    platform: Platform;
+    field: keyof FieldOverrides;
+    override: boolean;
+}
+export declare function useToggleMonthlyFieldOverride(): import("@tanstack/react-query").UseMutationResult<{
+    message: string;
+}, Error, ToggleMonthlyOverrideParams>;
+export interface RevenueSummary {
+    mrr: number;
+    arr: number;
+    total_paid_subscribers: number;
+    subscribers_by_tier: Record<string, number>;
+    arpu: number;
+    mrr_change_percent: number | null;
+    new_paid_this_month: number;
+    churned_this_month: number;
+}
+export interface EngagementSummary {
+    dau: number;
+    wau: number;
+    mau: number;
+    dau_mau_ratio: number;
+    avg_threads_per_active_user: number;
+    total_threads_today: number;
+    total_threads_week: number;
+    retention_d1: number | null;
+    retention_d7: number | null;
+    retention_d30: number | null;
+}
+export interface TaskPerformance {
+    total_runs: number;
+    completed_runs: number;
+    failed_runs: number;
+    stopped_runs: number;
+    running_runs: number;
+    pending_runs: number;
+    success_rate: number;
+    avg_duration_seconds: number | null;
+    avg_duration_with_stuck_seconds: number | null;
+    stuck_task_count: number;
+    runs_by_status: Record<string, number>;
+}
+export interface ToolUsage {
+    tool_name: string;
+    usage_count: number;
+    unique_threads: number;
+    percentage_of_threads: number;
+}
+export interface ToolAdoptionSummary {
+    total_tool_calls: number;
+    total_threads_with_tools: number;
+    top_tools: ToolUsage[];
+    tool_adoption_rate: number;
+}
+export declare function useRevenueSummary(): import("@tanstack/react-query").UseQueryResult<RevenueSummary, Error>;
+export declare function useEngagementSummary(dateFrom?: string, dateTo?: string): import("@tanstack/react-query").UseQueryResult<EngagementSummary, Error>;
+export declare function useTaskPerformance(dateFrom?: string, dateTo?: string): import("@tanstack/react-query").UseQueryResult<TaskPerformance, Error>;
+export declare function useToolAdoption(date?: string): import("@tanstack/react-query").UseQueryResult<ToolAdoptionSummary, Error>;
+export interface TierProfitability {
+    tier: string;
+    display_name: string;
+    provider: 'stripe' | 'revenuecat';
+    payment_count: number;
+    unique_users: number;
+    usage_users: number;
+    total_revenue: number;
+    total_cost: number;
+    total_actual_cost: number;
+    gross_profit: number;
+    gross_margin_percent: number;
+    avg_cost_per_user: number;
+    avg_revenue_per_user: number;
+    avg_profit_per_user: number;
+}
+export interface ProfitabilitySummary {
+    total_revenue: number;
+    total_cost: number;
+    total_actual_cost: number;
+    gross_profit: number;
+    gross_margin_percent: number;
+    by_tier: TierProfitability[];
+    web_revenue: number;
+    web_cost: number;
+    web_profit: number;
+    app_revenue: number;
+    app_cost: number;
+    app_profit: number;
+    avg_revenue_per_paid_user: number;
+    avg_cost_per_active_user: number;
+    unique_paying_users: number;
+    unique_active_users: number;
+    paying_user_emails: string[];
+    total_active_subscriptions: number;
+    stripe_active_subscriptions: number;
+    revenuecat_active_subscriptions: number;
+    period_start: string;
+    period_end: string;
+    total_payments: number;
+}
+export declare function useProfitability(dateFrom?: string, dateTo?: string): import("@tanstack/react-query").UseQueryResult<ProfitabilitySummary, Error>;
+export {};

package/dist/react/use-admin-analytics.js

@@ -0,0 +1,85 @@
+import { useRetiredMutation, useRetiredQuery } from './retired-endpoint.js';
+export function useAnalyticsSummary() {
+    return useRetiredQuery('useAnalyticsSummary', ['admin', 'analytics', 'summary']);
+}
+export function useThreadBrowser(params = {}) {
+    return useRetiredQuery('useThreadBrowser', ['admin', 'analytics', 'threads', params]);
+}
+export function useMessageDistribution(dateFrom, dateTo, enabled = true) {
+    return useRetiredQuery('useMessageDistribution', ['admin', 'analytics', 'message-distribution', dateFrom, dateTo], enabled);
+}
+export function useCategoryDistribution(dateFrom, dateTo, tier, enabled = true) {
+    return useRetiredQuery('useCategoryDistribution', ['admin', 'analytics', 'category-distribution', dateFrom, dateTo, tier], enabled);
+}
+export function useTierDistribution(dateFrom, dateTo, enabled = true) {
+    return useRetiredQuery('useTierDistribution', ['admin', 'analytics', 'tier-distribution', dateFrom, dateTo], enabled);
+}
+export function useVisitorStats(date, source = 'vercel') {
+    return useRetiredQuery('useVisitorStats', ['admin', 'analytics', 'visitors', date, source]);
+}
+export function useConversionFunnel(dateFrom, dateTo, source = 'vercel') {
+    return useRetiredQuery('useConversionFunnel', ['admin', 'analytics', 'conversion-funnel', dateFrom, dateTo, source]);
+}
+export function useRetentionData(params = {}) {
+    return useRetiredQuery('useRetentionData', ['admin', 'analytics', 'retention', params]);
+}
+export function useTranslate() {
+    return useRetiredMutation('useTranslate');
+}
+export function useARRWeeklyActuals() {
+    return useRetiredQuery('useARRWeeklyActuals', ['admin', 'analytics', 'arr-actuals']);
+}
+export function useUpdateARRWeeklyActual() {
+    return useRetiredMutation('useUpdateARRWeeklyActual');
+}
+export function useDeleteARRWeeklyActual() {
+    return useRetiredMutation('useDeleteARRWeeklyActual');
+}
+export function useToggleFieldOverride() {
+    return useRetiredMutation('useToggleFieldOverride');
+}
+export function useARRSimulatorConfig() {
+    return useRetiredQuery('useARRSimulatorConfig', ['admin', 'analytics', 'arr-config']);
+}
+export function useUpdateARRSimulatorConfig() {
+    return useRetiredMutation('useUpdateARRSimulatorConfig');
+}
+export function useSignupsByDate(dateFrom, dateTo) {
+    return useRetiredQuery('useSignupsByDate', ['admin', 'analytics', 'signups-by-date', dateFrom, dateTo], !!dateFrom && !!dateTo);
+}
+export function useViewsByDate(dateFrom, dateTo, source = 'vercel') {
+    return useRetiredQuery('useViewsByDate', ['admin', 'analytics', 'views-by-date', dateFrom, dateTo, source], !!dateFrom && !!dateTo);
+}
+export function useNewPaidByDate(dateFrom, dateTo) {
+    return useRetiredQuery('useNewPaidByDate', ['admin', 'analytics', 'new-paid-by-date', dateFrom, dateTo], !!dateFrom && !!dateTo);
+}
+export function useChurnByDate(dateFrom, dateTo) {
+    return useRetiredQuery('useChurnByDate', ['admin', 'analytics', 'churn-by-date', dateFrom, dateTo], !!dateFrom && !!dateTo);
+}
+export function useARRMonthlyActuals() {
+    return useRetiredQuery('useARRMonthlyActuals', ['admin', 'analytics', 'arr-monthly-actuals']);
+}
+export function useUpdateARRMonthlyActual() {
+    return useRetiredMutation('useUpdateARRMonthlyActual');
+}
+export function useDeleteARRMonthlyActual() {
+    return useRetiredMutation('useDeleteARRMonthlyActual');
+}
+export function useToggleMonthlyFieldOverride() {
+    return useRetiredMutation('useToggleMonthlyFieldOverride');
+}
+export function useRevenueSummary() {
+    return useRetiredQuery('useRevenueSummary', ['admin', 'analytics', 'revenue-summary']);
+}
+export function useEngagementSummary(dateFrom, dateTo) {
+    return useRetiredQuery('useEngagementSummary', ['admin', 'analytics', 'engagement-summary', dateFrom, dateTo]);
+}
+export function useTaskPerformance(dateFrom, dateTo) {
+    return useRetiredQuery('useTaskPerformance', ['admin', 'analytics', 'task-performance', dateFrom, dateTo]);
+}
+export function useToolAdoption(date) {
+    return useRetiredQuery('useToolAdoption', ['admin', 'analytics', 'tool-adoption', date]);
+}
+export function useProfitability(dateFrom, dateTo) {
+    return useRetiredQuery('useProfitability', ['admin', 'analytics', 'profitability', dateFrom, dateTo]);
+}

package/dist/react/use-admin-billing.d.ts

@@ -0,0 +1,26 @@
+interface CreditAdjustmentRequest {
+    account_id: string;
+    amount: number;
+    reason: string;
+    is_expiring: boolean;
+    notify_user: boolean;
+}
+interface RefundRequest {
+    account_id: string;
+    amount: number;
+    reason: string;
+    is_expiring: boolean;
+    stripe_refund: boolean;
+    payment_intent_id?: string;
+}
+export declare function useUserBillingSummary(userId: string | null): import("@tanstack/react-query").UseQueryResult<any, Error>;
+interface TransactionParams {
+    userId: string;
+    page?: number;
+    page_size?: number;
+    type_filter?: string;
+}
+export declare function useAdminUserTransactions(params: TransactionParams): import("@tanstack/react-query").UseQueryResult<any, Error>;
+export declare function useAdjustCredits(): import("@tanstack/react-query").UseMutationResult<any, Error, CreditAdjustmentRequest>;
+export declare function useProcessRefund(): import("@tanstack/react-query").UseMutationResult<any, Error, RefundRequest>;
+export {};

package/dist/react/use-admin-billing.js

@@ -0,0 +1,13 @@
+import { useRetiredMutation, useRetiredQuery } from './retired-endpoint.js';
+export function useUserBillingSummary(userId) {
+    return useRetiredQuery('useUserBillingSummary', ['admin', 'billing', 'user', userId], !!userId);
+}
+export function useAdminUserTransactions(params) {
+    return useRetiredQuery('useAdminUserTransactions', ['admin', 'billing', 'transactions', params.userId, params.page, params.page_size, params.type_filter], !!params.userId);
+}
+export function useAdjustCredits() {
+    return useRetiredMutation('useAdjustCredits');
+}
+export function useProcessRefund() {
+    return useRetiredMutation('useProcessRefund');
+}

package/dist/react/use-admin-feedback.d.ts

@@ -0,0 +1,118 @@
+export interface FeedbackWithUser {
+    feedback_id: string;
+    account_id: string;
+    user_email: string;
+    rating: number;
+    feedback_text?: string | null;
+    help_improve: boolean;
+    thread_id?: string | null;
+    message_id?: string | null;
+    context?: Record<string, any> | null;
+    created_at: string;
+    updated_at: string;
+}
+interface PaginationMeta {
+    current_page: number;
+    page_size: number;
+    total_items: number;
+    total_pages: number;
+    has_next: boolean;
+    has_previous: boolean;
+    next_cursor?: string | null;
+    previous_cursor?: string | null;
+}
+interface FeedbackListResponse {
+    data: FeedbackWithUser[];
+    pagination: PaginationMeta;
+}
+interface FeedbackListParams {
+    page?: number;
+    page_size?: number;
+    rating_filter?: number;
+    has_text?: boolean;
+    sort_by?: string;
+    sort_order?: 'asc' | 'desc';
+}
+export interface FeedbackStats {
+    total_feedback: number;
+    average_rating: number;
+    total_with_text: number;
+    rating_distribution: Record<string, number>;
+}
+export interface SentimentSummary {
+    total: number;
+    positive: number;
+    neutral: number;
+    negative: number;
+    five_star: number;
+    critical: number;
+    positive_percentage: number;
+    negative_percentage: number;
+}
+export interface TimeSeriesPoint {
+    period: string;
+    count: number;
+    avg_rating: number;
+    positive_count: number;
+    negative_count: number;
+    with_text_count: number;
+}
+export interface RatingTrends {
+    periods: string[];
+    data: Record<string, Record<string, number>>;
+}
+export interface CriticalFeedback {
+    feedback_id: string;
+    rating: number;
+    feedback_text: string;
+    created_at: string;
+    thread_id?: string | null;
+    user_email: string;
+}
+export interface ImprovementArea {
+    area: string;
+    severity: 'high' | 'medium' | 'low';
+    frequency: string;
+    user_quotes: string[];
+    suggested_action: string;
+}
+export interface ActionableRecommendation {
+    recommendation: string;
+    priority: 'high' | 'medium' | 'low';
+    effort: 'small' | 'medium' | 'large';
+    impact: string;
+    implementation_hint: string;
+}
+export interface LLMAnalysisResponse {
+    analysis: string;
+    key_themes: string[];
+    improvement_areas: ImprovementArea[];
+    positive_highlights: string[];
+    actionable_recommendations: ActionableRecommendation[];
+    feedback_analyzed_count: number;
+    generated_at: string;
+}
+export interface LLMAnalysisRequest {
+    focus_area?: 'negative' | 'positive' | 'all' | 'critical';
+    days?: number;
+    max_feedback?: number;
+}
+export declare function useAdminFeedbackList(params?: FeedbackListParams): import("@tanstack/react-query").UseQueryResult<FeedbackListResponse, Error>;
+export declare function useAdminFeedbackStats(): import("@tanstack/react-query").UseQueryResult<FeedbackStats, Error>;
+export declare function useAdminSentimentSummary(): import("@tanstack/react-query").UseQueryResult<SentimentSummary, Error>;
+export declare function useAdminFeedbackTimeSeries(days?: number, granularity?: string): import("@tanstack/react-query").UseQueryResult<TimeSeriesPoint[], Error>;
+export declare function useAdminRatingTrends(days?: number): import("@tanstack/react-query").UseQueryResult<RatingTrends, Error>;
+export declare function useAdminCriticalFeedback(limit?: number): import("@tanstack/react-query").UseQueryResult<CriticalFeedback[], Error>;
+export declare function useAdminFeedbackExport(params: {
+    rating_filter?: number;
+    has_text?: boolean;
+    start_date?: string;
+    end_date?: string;
+}): import("@tanstack/react-query").UseQueryResult<FeedbackWithUser[], Error>;
+export declare function useAdminFeedbackAnalysis(): import("@tanstack/react-query").UseMutationResult<LLMAnalysisResponse, Error, LLMAnalysisRequest>;
+export declare function useRefreshFeedbackData(): {
+    refreshFeedbackList: (params?: FeedbackListParams) => void;
+    refreshFeedbackStats: () => void;
+    refreshAll: () => void;
+};
+export {};

package/dist/react/use-admin-feedback.js

@@ -0,0 +1,46 @@
+import { useQueryClient } from '@tanstack/react-query';
+import { useRetiredMutation, useRetiredQuery } from './retired-endpoint.js';
+export function useAdminFeedbackList(params = {}) {
+    return useRetiredQuery('useAdminFeedbackList', ['admin', 'feedback', 'list', params]);
+}
+export function useAdminFeedbackStats() {
+    return useRetiredQuery('useAdminFeedbackStats', ['admin', 'feedback', 'stats']);
+}
+export function useAdminSentimentSummary() {
+    return useRetiredQuery('useAdminSentimentSummary', ['admin', 'feedback', 'sentiment']);
+}
+export function useAdminFeedbackTimeSeries(days = 30, granularity = 'day') {
+    return useRetiredQuery('useAdminFeedbackTimeSeries', ['admin', 'feedback', 'time-series', days, granularity]);
+}
+export function useAdminRatingTrends(days = 30) {
+    return useRetiredQuery('useAdminRatingTrends', ['admin', 'feedback', 'rating-trends', days]);
+}
+export function useAdminCriticalFeedback(limit = 20) {
+    return useRetiredQuery('useAdminCriticalFeedback', ['admin', 'feedback', 'critical', limit]);
+}
+export function useAdminFeedbackExport(params) {
+    return useRetiredQuery('useAdminFeedbackExport', ['admin', 'feedback', 'export', params], false);
+}
+export function useAdminFeedbackAnalysis() {
+    return useRetiredMutation('useAdminFeedbackAnalysis');
+}
+export function useRefreshFeedbackData() {
+    const queryClient = useQueryClient();
+    return {
+        refreshFeedbackList: (params) => {
+            queryClient.invalidateQueries({
+                queryKey: ['admin', 'feedback', 'list'],
+            });
+        },
+        refreshFeedbackStats: () => {
+            queryClient.invalidateQueries({
+                queryKey: ['admin', 'feedback', 'stats'],
+            });
+        },
+        refreshAll: () => {
+            queryClient.invalidateQueries({
+                queryKey: ['admin', 'feedback'],
+            });
+        },
+    };
+}

package/dist/react/use-admin-projects.d.ts

@@ -0,0 +1,31 @@
+export interface AdminProject {
+    projectId: string;
+    name: string;
+    status: string | null;
+    accountId: string;
+    accountName: string | null;
+    ownerEmail: string | null;
+    createdAt: string | null;
+    sessionCount: number;
+    activeSessionCount: number;
+    lastSessionAt: string | null;
+}
+export interface AdminProjectsResponse {
+    projects: AdminProject[];
+    total: number;
+    page: number;
+    limit: number;
+    error?: string;
+}
+export type AdminProjectsSortBy = 'activity' | 'created' | 'sessions';
+export type AdminProjectsSortDir = 'asc' | 'desc';
+export interface AdminProjectsFilters {
+    search?: string;
+    accountId?: string;
+    status?: string[];
+    sortBy?: AdminProjectsSortBy;
+    sortDir?: AdminProjectsSortDir;
+    page?: number;
+    limit?: number;
+}
+export declare function useAdminProjects(filters?: AdminProjectsFilters): import("@tanstack/react-query").UseQueryResult<AdminProjectsResponse, Error>;

package/dist/react/use-admin-projects.js

@@ -0,0 +1,27 @@
+import { useQuery } from '@tanstack/react-query';
+import { backendApi } from '../core/http/api-client.js';
+export function useAdminProjects(filters = {}) {
+    const { search = '', accountId = '', status = [], sortBy = 'activity', sortDir = 'desc', page = 1, limit = 50, } = filters;
+    return useQuery({
+        queryKey: ['admin', 'projects', search, accountId, status.join(','), sortBy, sortDir, page, limit],
+        queryFn: async () => {
+            const q = new URLSearchParams();
+            if (search)
+                q.set('search', search);
+            if (accountId)
+                q.set('accountId', accountId);
+            if (status.length)
+                q.set('status', status.join(','));
+            q.set('sortBy', sortBy);
+            q.set('sortDir', sortDir);
+            q.set('page', String(page));
+            q.set('limit', String(limit));
+            const response = await backendApi.get(`/admin/api/projects?${q.toString()}`);
+            if (response.error)
+                throw new Error(response.error.message);
+            return response.data;
+        },
+        staleTime: 15_000,
+        placeholderData: (prev) => prev,
+    });
+}