@elqnt/admin 2.2.1 → 2.3.1

package/dist/hooks/index.d.cts

@@ -1,249 +1,130 @@
 import { ApiClientOptions } from '@elqnt/api-client';
-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.cjs';
-import { L as ListOrgsFilter, P as ProvisioningProgress, V as ValidationResult } from '../provisioning-Cfl6wbmV.cjs';
+import { b as Org, as as OrgInfo, ba as User, bf as UserSettingsResponse, be as UserSettings, a9 as NotificationPreferences, S as Invite, T as InviteInput, a2 as InvitesResult } from '../admin-C1iVQe2d.cjs';
 import { OrgSettings } from '@elqnt/agents/models';
+import { L as ListOrgsFilter } from '../orgs-Buu2Re0N.cjs';
 import '@elqnt/types';
 
 type UseOrgAdminOptions = ApiClientOptions;
 /**
- * Hook for organization CRUD operations
- *
- * @example
- * ```tsx
- * const { loading, error, listOrgs, createOrg, updateOrg } = useOrgAdmin({
- *   baseUrl: apiGatewayUrl,
- *   orgId: selectedOrgId,
- *   userId: user?.id,
- *   userEmail: user?.email,
- * });
+ * The exact, stable return surface of `useOrgAdmin`.
  *
- * const orgs = await listOrgs();
- * const newOrg = await createOrg({ name: "Acme Corp" });
- * ```
+ * This is the agent/consumer **contract**: the only members that exist on the
+ * org-admin hook (org CRUD + the settings methods folded in from the former
+ * `useOrgSettings`). Every method is imperative and DOES NOT throw — on failure
+ * it resolves to the documented default (`[]`, `null`, `false`) and sets
+ * `error`. See `SKILL.md`.
  */
-declare function useOrgAdmin(options: UseOrgAdminOptions): {
+interface UseOrgAdminReturn {
+    /** True while any in-flight call runs. */
     loading: boolean;
+    /** Last error message, else null. */
     error: string | null;
+    /** GET /api/v1/admin/orgs (optional ?status&type&product) — default []. */
     listOrgs: (filter?: ListOrgsFilter) => Promise<Org[]>;
+    /** GET /api/v1/admin/orgs/{orgId} — default null. */
     getOrg: (orgId: string) => Promise<Org | null>;
+    /** GET /api/v1/admin/orgs/{orgId}/info (lightweight) — default null. */
     getOrgInfo: (orgId: string) => Promise<OrgInfo | null>;
-    createOrg: (org: Partial<Org>) => Promise<Org | null>;
-    createOrgWithSchemas: (org: Partial<Org>, schemas: OrgSchemaTypeTS[]) => Promise<CreateOrgWithSchemasResponse | null>;
+    /** POST /api/v1/admin/orgs — created org, or null on error. `product` is transient routing metadata. */
+    createOrg: (org: Partial<Org> & {
+        product?: string;
+    }) => Promise<Org | null>;
+    /** PUT /api/v1/admin/orgs/{orgId} — updated org, or null on error. */
     updateOrg: (orgId: string, updates: Partial<Org>) => Promise<Org | null>;
+    /** DELETE /api/v1/admin/orgs/{orgId} — true on success. */
     deleteOrg: (orgId: string) => Promise<boolean>;
-};
-
-type UseUsersAdminOptions = ApiClientOptions;
+    /** GET /api/v1/admin/orgs/{orgId} → OrgSettings — default null. */
+    getSettings: () => Promise<OrgSettings | null>;
+    /** Alias for updateSettings (settings rows always exist). PUT /api/v1/admin/orgs/{orgId}. */
+    createSettings: (settings: Partial<OrgSettings>) => Promise<OrgSettings | null>;
+    /** PUT /api/v1/admin/orgs/{orgId} then re-GET — updated OrgSettings, or null on error. */
+    updateSettings: (settings: Partial<OrgSettings>) => Promise<OrgSettings | null>;
+}
 /**
- * Hook for user CRUD operations
+ * Hook for organization CRUD operations
  *
  * @example
  * ```tsx
- * const { loading, error, listUsers, createUser, updateUser } = useUsersAdmin({
+ * const { loading, error, listOrgs, createOrg, updateOrg } = useOrgAdmin({
  *   baseUrl: apiGatewayUrl,
  *   orgId: selectedOrgId,
  *   userId: user?.id,
  *   userEmail: user?.email,
  * });
  *
- * const users = await listUsers();
- * const user = await getUserByEmail("user@example.com");
+ * const orgs = await listOrgs();
+ * const newOrg = await createOrg({ name: "Acme Corp" });
  * ```
  */
-declare function useUsersAdmin(options: UseUsersAdminOptions): {
+declare function useOrgAdmin(options: UseOrgAdminOptions): UseOrgAdminReturn;
+
+type UseUsersAdminOptions = ApiClientOptions;
+/**
+ * The exact, stable return surface of `useUsersAdmin`.
+ *
+ * Agent/consumer **contract**: the only members on the users-admin hook (user
+ * CRUD + the invitation methods folded in from the former `useInvitesAdmin`).
+ * Every method is imperative and DOES NOT throw — on failure it resolves to its
+ * default (`[]`, `null`, `false`) and sets `error`. See `SKILL.md`.
+ */
+interface UseUsersAdminReturn {
+    /** True while any in-flight call runs. */
     loading: boolean;
+    /** Last error message, else null. */
     error: string | null;
+    /** GET /api/v1/admin/users — default []. */
     listUsers: () => Promise<User[]>;
+    /** GET /api/v1/admin/users/{userId} — default null. */
     getUser: (userId: string) => Promise<User | null>;
+    /** GET /api/v1/admin/users/by-email?email= — default null. */
     getUserByEmail: (email: string) => Promise<User | null>;
+    /** GET /api/v1/admin/users/by-phone?phone= — default null. */
     getUserByPhone: (phone: string) => Promise<User | null>;
+    /** POST /api/v1/admin/users — created user, or null on error. */
     createUser: (user: Partial<User>) => Promise<User | null>;
+    /** PUT /api/v1/admin/users/{userId} — updated user, or null on error. */
     updateUser: (userId: string, updates: Partial<User>) => Promise<User | null>;
+    /** DELETE /api/v1/admin/users/{userId} — true on success. */
     deleteUser: (userId: string) => Promise<boolean>;
+    /** GET /api/v1/admin/users/{userId}/settings — default null. */
     getUserSettings: (userId: string) => Promise<UserSettingsResponse | null>;
+    /** PUT /api/v1/admin/users/{userId}/settings — updated settings, or null on error. */
     updateUserSettings: (userId: string, settings: {
         settings?: UserSettings;
         notificationPreferences?: NotificationPreferences;
     }) => Promise<UserSettingsResponse | null>;
-};
-
-type UseInvitesAdminOptions = ApiClientOptions;
-/**
- * Hook for invitation CRUD operations
- *
- * @example
- * ```tsx
- * const { loading, error, listInvites, sendInvite, revokeInvite } = useInvitesAdmin({
- *   baseUrl: apiGatewayUrl,
- *   orgId: selectedOrgId,
- *   userId: user?.id,
- *   userEmail: user?.email,
- * });
- *
- * const invites = await listInvites();
- * await sendInvite({ email: "user@example.com", role: "member" });
- * ```
- */
-declare function useInvitesAdmin(options: UseInvitesAdminOptions): {
-    loading: boolean;
-    error: string | null;
+    /** GET /api/v1/admin/invites — default []. */
     listInvites: () => Promise<Invite[]>;
+    /** GET /api/v1/admin/invites/{inviteId} — default null. */
     getInvite: (inviteId: string) => Promise<Invite | null>;
+    /** POST /api/v1/admin/invites/single — created invite, or null on error. */
     sendInvite: (invite: InviteInput) => Promise<Invite | null>;
+    /** POST /api/v1/admin/invites, body { invites } — batch result, or null on error. */
     sendInvites: (invites: InviteInput[]) => Promise<InvitesResult | null>;
+    /** POST /api/v1/admin/invites/{inviteId}/resend — invite, or null on error. */
     resendInvite: (inviteId: string) => Promise<Invite | null>;
+    /** DELETE /api/v1/admin/invites/{inviteId} — true on success. */
     revokeInvite: (inviteId: string) => Promise<boolean>;
+    /** POST /api/v1/admin/invites/{inviteId}/accept — invite, or null on error. */
     acceptInvite: (inviteId: string) => Promise<Invite | null>;
-};
-
-type UseOrgSettingsOptions = ApiClientOptions;
-/**
- * Hook for organization settings CRUD operations
- *
- * @example
- * ```tsx
- * const { loading, error, getSettings, createSettings, updateSettings } = useOrgSettings({
- *   baseUrl: apiGatewayUrl,
- *   orgId: selectedOrgId,
- * });
- *
- * const settings = await getSettings();
- * await updateSettings({ timezone: "America/New_York" });
- * ```
- */
-declare function useOrgSettings(options: UseOrgSettingsOptions): {
-    loading: boolean;
-    error: string | null;
-    getSettings: () => Promise<OrgSettings | null>;
-    createSettings: (settings: Partial<OrgSettings>) => Promise<OrgSettings | null>;
-    updateSettings: (settings: Partial<OrgSettings>) => Promise<OrgSettings | null>;
-};
-
-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
+ * Hook for user + invitation CRUD operations
  *
  * @example
  * ```tsx
- * const {
- *   loading,
- *   error,
- *   summary,
- *   getSummary,
- *   trackEvent,
- * } = useProductAnalytics({
+ * const { loading, error, listUsers, createUser, updateUser, listInvites, sendInvite } = useUsersAdmin({
  *   baseUrl: apiGatewayUrl,
- *   orgId: user?.orgId,
+ *   orgId: selectedOrgId,
  *   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
+ * const users = await listUsers();
+ * const user = await getUserByEmail("user@example.com");
+ * await sendInvite({ email: "user@example.com", role: "member" });
  * ```
  */
-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;
-};
+declare function useUsersAdmin(options: UseUsersAdminOptions): UseUsersAdminReturn;
 
-export { type ProductAnalyticsState, type ProvisioningState, type UseInvitesAdminOptions, type UseOrgAdminOptions, type UseOrgProvisioningOptions, type UseOrgSettingsOptions, type UseProductAnalyticsOptions, type UseUsersAdminOptions, useAnalyticsContext, useInvitesAdmin, useOrgAdmin, useOrgProvisioning, useOrgSettings, useProductAnalytics, useUsersAdmin };
+export { type UseOrgAdminOptions, type UseOrgAdminReturn, type UseUsersAdminOptions, type UseUsersAdminReturn, useOrgAdmin, useUsersAdmin };

package/dist/hooks/index.d.ts

@@ -1,249 +1,130 @@
 import { ApiClientOptions } from '@elqnt/api-client';
-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 { b as Org, as as OrgInfo, ba as User, bf as UserSettingsResponse, be as UserSettings, a9 as NotificationPreferences, S as Invite, T as InviteInput, a2 as InvitesResult } from '../admin-C1iVQe2d.js';
 import { OrgSettings } from '@elqnt/agents/models';
+import { L as ListOrgsFilter } from '../orgs-BSHeYVe-.js';
 import '@elqnt/types';
 
 type UseOrgAdminOptions = ApiClientOptions;
 /**
- * Hook for organization CRUD operations
- *
- * @example
- * ```tsx
- * const { loading, error, listOrgs, createOrg, updateOrg } = useOrgAdmin({
- *   baseUrl: apiGatewayUrl,
- *   orgId: selectedOrgId,
- *   userId: user?.id,
- *   userEmail: user?.email,
- * });
+ * The exact, stable return surface of `useOrgAdmin`.
  *
- * const orgs = await listOrgs();
- * const newOrg = await createOrg({ name: "Acme Corp" });
- * ```
+ * This is the agent/consumer **contract**: the only members that exist on the
+ * org-admin hook (org CRUD + the settings methods folded in from the former
+ * `useOrgSettings`). Every method is imperative and DOES NOT throw — on failure
+ * it resolves to the documented default (`[]`, `null`, `false`) and sets
+ * `error`. See `SKILL.md`.
  */
-declare function useOrgAdmin(options: UseOrgAdminOptions): {
+interface UseOrgAdminReturn {
+    /** True while any in-flight call runs. */
     loading: boolean;
+    /** Last error message, else null. */
     error: string | null;
+    /** GET /api/v1/admin/orgs (optional ?status&type&product) — default []. */
     listOrgs: (filter?: ListOrgsFilter) => Promise<Org[]>;
+    /** GET /api/v1/admin/orgs/{orgId} — default null. */
     getOrg: (orgId: string) => Promise<Org | null>;
+    /** GET /api/v1/admin/orgs/{orgId}/info (lightweight) — default null. */
     getOrgInfo: (orgId: string) => Promise<OrgInfo | null>;
-    createOrg: (org: Partial<Org>) => Promise<Org | null>;
-    createOrgWithSchemas: (org: Partial<Org>, schemas: OrgSchemaTypeTS[]) => Promise<CreateOrgWithSchemasResponse | null>;
+    /** POST /api/v1/admin/orgs — created org, or null on error. `product` is transient routing metadata. */
+    createOrg: (org: Partial<Org> & {
+        product?: string;
+    }) => Promise<Org | null>;
+    /** PUT /api/v1/admin/orgs/{orgId} — updated org, or null on error. */
     updateOrg: (orgId: string, updates: Partial<Org>) => Promise<Org | null>;
+    /** DELETE /api/v1/admin/orgs/{orgId} — true on success. */
     deleteOrg: (orgId: string) => Promise<boolean>;
-};
-
-type UseUsersAdminOptions = ApiClientOptions;
+    /** GET /api/v1/admin/orgs/{orgId} → OrgSettings — default null. */
+    getSettings: () => Promise<OrgSettings | null>;
+    /** Alias for updateSettings (settings rows always exist). PUT /api/v1/admin/orgs/{orgId}. */
+    createSettings: (settings: Partial<OrgSettings>) => Promise<OrgSettings | null>;
+    /** PUT /api/v1/admin/orgs/{orgId} then re-GET — updated OrgSettings, or null on error. */
+    updateSettings: (settings: Partial<OrgSettings>) => Promise<OrgSettings | null>;
+}
 /**
- * Hook for user CRUD operations
+ * Hook for organization CRUD operations
  *
  * @example
  * ```tsx
- * const { loading, error, listUsers, createUser, updateUser } = useUsersAdmin({
+ * const { loading, error, listOrgs, createOrg, updateOrg } = useOrgAdmin({
  *   baseUrl: apiGatewayUrl,
  *   orgId: selectedOrgId,
  *   userId: user?.id,
  *   userEmail: user?.email,
  * });
  *
- * const users = await listUsers();
- * const user = await getUserByEmail("user@example.com");
+ * const orgs = await listOrgs();
+ * const newOrg = await createOrg({ name: "Acme Corp" });
  * ```
  */
-declare function useUsersAdmin(options: UseUsersAdminOptions): {
+declare function useOrgAdmin(options: UseOrgAdminOptions): UseOrgAdminReturn;
+
+type UseUsersAdminOptions = ApiClientOptions;
+/**
+ * The exact, stable return surface of `useUsersAdmin`.
+ *
+ * Agent/consumer **contract**: the only members on the users-admin hook (user
+ * CRUD + the invitation methods folded in from the former `useInvitesAdmin`).
+ * Every method is imperative and DOES NOT throw — on failure it resolves to its
+ * default (`[]`, `null`, `false`) and sets `error`. See `SKILL.md`.
+ */
+interface UseUsersAdminReturn {
+    /** True while any in-flight call runs. */
     loading: boolean;
+    /** Last error message, else null. */
     error: string | null;
+    /** GET /api/v1/admin/users — default []. */
     listUsers: () => Promise<User[]>;
+    /** GET /api/v1/admin/users/{userId} — default null. */
     getUser: (userId: string) => Promise<User | null>;
+    /** GET /api/v1/admin/users/by-email?email= — default null. */
     getUserByEmail: (email: string) => Promise<User | null>;
+    /** GET /api/v1/admin/users/by-phone?phone= — default null. */
     getUserByPhone: (phone: string) => Promise<User | null>;
+    /** POST /api/v1/admin/users — created user, or null on error. */
     createUser: (user: Partial<User>) => Promise<User | null>;
+    /** PUT /api/v1/admin/users/{userId} — updated user, or null on error. */
     updateUser: (userId: string, updates: Partial<User>) => Promise<User | null>;
+    /** DELETE /api/v1/admin/users/{userId} — true on success. */
     deleteUser: (userId: string) => Promise<boolean>;
+    /** GET /api/v1/admin/users/{userId}/settings — default null. */
     getUserSettings: (userId: string) => Promise<UserSettingsResponse | null>;
+    /** PUT /api/v1/admin/users/{userId}/settings — updated settings, or null on error. */
     updateUserSettings: (userId: string, settings: {
         settings?: UserSettings;
         notificationPreferences?: NotificationPreferences;
     }) => Promise<UserSettingsResponse | null>;
-};
-
-type UseInvitesAdminOptions = ApiClientOptions;
-/**
- * Hook for invitation CRUD operations
- *
- * @example
- * ```tsx
- * const { loading, error, listInvites, sendInvite, revokeInvite } = useInvitesAdmin({
- *   baseUrl: apiGatewayUrl,
- *   orgId: selectedOrgId,
- *   userId: user?.id,
- *   userEmail: user?.email,
- * });
- *
- * const invites = await listInvites();
- * await sendInvite({ email: "user@example.com", role: "member" });
- * ```
- */
-declare function useInvitesAdmin(options: UseInvitesAdminOptions): {
-    loading: boolean;
-    error: string | null;
+    /** GET /api/v1/admin/invites — default []. */
     listInvites: () => Promise<Invite[]>;
+    /** GET /api/v1/admin/invites/{inviteId} — default null. */
     getInvite: (inviteId: string) => Promise<Invite | null>;
+    /** POST /api/v1/admin/invites/single — created invite, or null on error. */
     sendInvite: (invite: InviteInput) => Promise<Invite | null>;
+    /** POST /api/v1/admin/invites, body { invites } — batch result, or null on error. */
     sendInvites: (invites: InviteInput[]) => Promise<InvitesResult | null>;
+    /** POST /api/v1/admin/invites/{inviteId}/resend — invite, or null on error. */
     resendInvite: (inviteId: string) => Promise<Invite | null>;
+    /** DELETE /api/v1/admin/invites/{inviteId} — true on success. */
     revokeInvite: (inviteId: string) => Promise<boolean>;
+    /** POST /api/v1/admin/invites/{inviteId}/accept — invite, or null on error. */
     acceptInvite: (inviteId: string) => Promise<Invite | null>;
-};
-
-type UseOrgSettingsOptions = ApiClientOptions;
-/**
- * Hook for organization settings CRUD operations
- *
- * @example
- * ```tsx
- * const { loading, error, getSettings, createSettings, updateSettings } = useOrgSettings({
- *   baseUrl: apiGatewayUrl,
- *   orgId: selectedOrgId,
- * });
- *
- * const settings = await getSettings();
- * await updateSettings({ timezone: "America/New_York" });
- * ```
- */
-declare function useOrgSettings(options: UseOrgSettingsOptions): {
-    loading: boolean;
-    error: string | null;
-    getSettings: () => Promise<OrgSettings | null>;
-    createSettings: (settings: Partial<OrgSettings>) => Promise<OrgSettings | null>;
-    updateSettings: (settings: Partial<OrgSettings>) => Promise<OrgSettings | null>;
-};
-
-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
+ * Hook for user + invitation CRUD operations
  *
  * @example
  * ```tsx
- * const {
- *   loading,
- *   error,
- *   summary,
- *   getSummary,
- *   trackEvent,
- * } = useProductAnalytics({
+ * const { loading, error, listUsers, createUser, updateUser, listInvites, sendInvite } = useUsersAdmin({
  *   baseUrl: apiGatewayUrl,
- *   orgId: user?.orgId,
+ *   orgId: selectedOrgId,
  *   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
+ * const users = await listUsers();
+ * const user = await getUserByEmail("user@example.com");
+ * await sendInvite({ email: "user@example.com", role: "member" });
  * ```
  */
-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;
-};
+declare function useUsersAdmin(options: UseUsersAdminOptions): UseUsersAdminReturn;
 
-export { type ProductAnalyticsState, type ProvisioningState, type UseInvitesAdminOptions, type UseOrgAdminOptions, type UseOrgProvisioningOptions, type UseOrgSettingsOptions, type UseProductAnalyticsOptions, type UseUsersAdminOptions, useAnalyticsContext, useInvitesAdmin, useOrgAdmin, useOrgProvisioning, useOrgSettings, useProductAnalytics, useUsersAdmin };
+export { type UseOrgAdminOptions, type UseOrgAdminReturn, type UseUsersAdminOptions, type UseUsersAdminReturn, useOrgAdmin, useUsersAdmin };