@elqnt/admin 2.1.0 → 2.2.0

package/dist/hooks/index.d.ts

@@ -1,5 +1,6 @@
 import { ApiClientOptions } from '@elqnt/api-client';
-import { ab as Org, ac as OrgInfo, bj as User, bo as UserSettingsResponse, bn as UserSettings, Z as NotificationPreferences, I as Invite, F as InviteInput, R as InvitesResult } from '../admin-Dlsd5IZ0.js';
+import { Org, OrgInfo, OrgSchemaTypeTS, CreateOrgWithSchemasResponse, User, UserSettingsResponse, UserSettings, NotificationPreferences, Invite, InviteInput, InvitesResult, AnalyticsSummary, ChatAnalytics, AgentAnalytics, UsageAnalytics, DailyAnalytics, AnalyticsEvent, DateFilter, GlobalAnalyticsSummary, OrgAnalytics, CreateOrgRequest, OrgArtifactTypeTS } from '../models/index.js';
+import { L as ListOrgsFilter, P as ProvisioningProgress, V as ValidationResult } from '../provisioning-Il9t2jnH.js';
 import { OrgSettings } from '@elqnt/agents/models';
 import '@elqnt/types';
 
@@ -23,10 +24,11 @@ type UseOrgAdminOptions = ApiClientOptions;
 declare function useOrgAdmin(options: UseOrgAdminOptions): {
     loading: boolean;
     error: string | null;
-    listOrgs: () => Promise<Org[]>;
+    listOrgs: (filter?: ListOrgsFilter) => Promise<Org[]>;
     getOrg: (orgId: string) => Promise<Org | null>;
     getOrgInfo: (orgId: string) => Promise<OrgInfo | null>;
     createOrg: (org: Partial<Org>) => Promise<Org | null>;
+    createOrgWithSchemas: (org: Partial<Org>, schemas: OrgSchemaTypeTS[]) => Promise<CreateOrgWithSchemasResponse | null>;
     updateOrg: (orgId: string, updates: Partial<Org>) => Promise<Org | null>;
     deleteOrg: (orgId: string) => Promise<boolean>;
 };
@@ -54,6 +56,7 @@ declare function useUsersAdmin(options: UseUsersAdminOptions): {
     listUsers: () => Promise<User[]>;
     getUser: (userId: string) => Promise<User | null>;
     getUserByEmail: (email: string) => Promise<User | null>;
+    getUserByPhone: (phone: string) => Promise<User | null>;
     createUser: (user: Partial<User>) => Promise<User | null>;
     updateUser: (userId: string, updates: Partial<User>) => Promise<User | null>;
     deleteUser: (userId: string) => Promise<boolean>;
@@ -116,4 +119,131 @@ declare function useOrgSettings(options: UseOrgSettingsOptions): {
     updateSettings: (settings: Partial<OrgSettings>) => Promise<OrgSettings | null>;
 };
 
-export { type UseInvitesAdminOptions, type UseOrgAdminOptions, type UseOrgSettingsOptions, type UseUsersAdminOptions, useInvitesAdmin, useOrgAdmin, useOrgSettings, useUsersAdmin };
+type UseProductAnalyticsOptions = ApiClientOptions;
+interface ProductAnalyticsState {
+    summary: AnalyticsSummary | null;
+    chats: ChatAnalytics[];
+    agents: AgentAnalytics[];
+    usage: UsageAnalytics[];
+    daily: DailyAnalytics[];
+    events: AnalyticsEvent[];
+    loading: boolean;
+    error: string | null;
+}
+/**
+ * Hook for product analytics queries and event tracking
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   loading,
+ *   error,
+ *   summary,
+ *   getSummary,
+ *   trackEvent,
+ * } = useProductAnalytics({
+ *   baseUrl: apiGatewayUrl,
+ *   orgId: user?.orgId,
+ *   userId: user?.id,
+ *   userEmail: user?.email,
+ * });
+ *
+ * // Fetch analytics
+ * await getSummary({ from: "2024-01-01", to: "2024-12-31" });
+ *
+ * // Track events
+ * trackEvent("button_click", "ui", { buttonId: "submit" });
+ * ```
+ */
+declare function useProductAnalytics(options: UseProductAnalyticsOptions): {
+    getSummary: (filter?: DateFilter) => Promise<AnalyticsSummary | null>;
+    getChats: (filter?: DateFilter, agentId?: string) => Promise<ChatAnalytics[]>;
+    getAgents: (filter?: DateFilter) => Promise<AgentAnalytics[]>;
+    getUsage: (filter?: DateFilter) => Promise<UsageAnalytics[]>;
+    getDaily: (filter?: DateFilter) => Promise<DailyAnalytics[]>;
+    getEvents: (filter?: DateFilter) => Promise<AnalyticsEvent[]>;
+    trackEvent: (eventType: string, eventCategory: string, properties?: Record<string, unknown>) => Promise<void>;
+    trackPageView: (pageName?: string) => Promise<void>;
+    getGlobalSummary: (filter?: DateFilter) => Promise<GlobalAnalyticsSummary | null>;
+    getGlobalOrgs: (filter?: DateFilter) => Promise<OrgAnalytics[]>;
+    summary: AnalyticsSummary | null;
+    chats: ChatAnalytics[];
+    agents: AgentAnalytics[];
+    usage: UsageAnalytics[];
+    daily: DailyAnalytics[];
+    events: AnalyticsEvent[];
+    loading: boolean;
+    error: string | null;
+};
+/**
+ * Hook to use analytics context (for event tracking throughout the app)
+ *
+ * This is an alias for useProductAnalytics that makes the intent clearer
+ * when used primarily for event tracking.
+ *
+ * @example
+ * ```tsx
+ * const { trackEvent } = useAnalyticsContext(options);
+ * trackEvent("form_submit", "ui", { formId: "contact" });
+ * ```
+ */
+declare const useAnalyticsContext: typeof useProductAnalytics;
+
+type UseOrgProvisioningOptions = ApiClientOptions;
+interface ProvisioningState {
+    status: "idle" | "creating" | "provisioning" | "completed" | "failed" | "partial";
+    progress: ProvisioningProgress | null;
+    org: Org | null;
+    error: string | null;
+    percentage: number;
+}
+/**
+ * Hook for organization provisioning with real-time progress
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   state,
+ *   createOrgWithProvisioning,
+ *   retryProvisioning,
+ *   cancelProvisioning,
+ * } = useOrgProvisioning({
+ *   baseUrl: apiGatewayUrl,
+ *   orgId: selectedOrgId,
+ * });
+ *
+ * // Create org and track progress
+ * await createOrgWithProvisioning({
+ *   title: "Acme Corp",
+ *   product: "eloquent",
+ * });
+ *
+ * // state.progress will update in real-time
+ * console.log(state.percentage); // 0-100
+ * ```
+ */
+declare function useOrgProvisioning(options: UseOrgProvisioningOptions): {
+    state: ProvisioningState;
+    createOrgWithProvisioning: (request: CreateOrgRequest) => Promise<Org | null>;
+    getProvisioningStatus: (orgId: string) => Promise<ProvisioningProgress | null>;
+    retryProvisioning: (orgId: string, artifacts?: OrgArtifactTypeTS[]) => Promise<boolean>;
+    validateProvisioning: (orgId: string) => Promise<ValidationResult | null>;
+    cancelProvisioning: (orgId: string) => Promise<boolean>;
+    cleanupOrg: (orgId: string) => Promise<boolean>;
+    reset: () => void;
+    isComplete: boolean;
+    isFailed: boolean;
+    isPartial: boolean;
+    isProvisioning: boolean;
+    failedArtifacts: {
+        type: OrgArtifactTypeTS;
+        status: string;
+        critical: boolean;
+        error?: string;
+        duration?: number;
+        estimatedDuration?: number;
+    }[];
+    hasCriticalFailures: boolean;
+};
+
+export { type ProductAnalyticsState, type ProvisioningState, type UseInvitesAdminOptions, type UseOrgAdminOptions, type UseOrgProvisioningOptions, type UseOrgSettingsOptions, type UseProductAnalyticsOptions, type UseUsersAdminOptions, useAnalyticsContext, useInvitesAdmin, useOrgAdmin, useOrgProvisioning, useOrgSettings, useProductAnalytics, useUsersAdmin };