@simple-auth-kit/cli 1.0.0

package/registry/admin-apps/react/variants/base/src/pages/CustomersPage.tsx

@@ -0,0 +1,404 @@
+import { useMemo, useState } from "react";
+import { Link } from "react-router-dom";
+import { type ColumnDef, type PaginationState, type SortingState, getCoreRowModel, getSortedRowModel, useReactTable } from "@tanstack/react-table";
+import { keepPreviousData, useQuery } from "@tanstack/react-query";
+import { useDebounce } from "use-debounce";
+import { format } from "date-fns";
+import { ChevronDownIcon, EyeIcon, PencilIcon, PlusIcon, PowerIcon, Trash2Icon } from "lucide-react";
+import { AuthApiError, type CustomerSummary } from "@simple-auth-kit/auth-client";
+import { toast } from "sonner";
+import { PERMISSIONS, useAbility } from "@/lib/ability";
+import { authClient } from "@/lib/auth-client";
+import { cn } from "@/lib/cn";
+import { AlertModal } from "@/components/alert-modal";
+import { Breadcrumb } from "@/components/breadcrumb";
+import { TableSkeletonLoader } from "@/components/loader/table-skeleton-loader";
+import { Avatar, AvatarFallback, AvatarImage } from "@/components/ui/avatar";
+import { Badge } from "@/components/ui/badge";
+import { Button, buttonVariants } from "@/components/ui/button";
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import { DataTable } from "@/components/ui/data-table";
+import { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuTrigger } from "@/components/ui/dropdown-menu";
+import { Input } from "@/components/ui/input";
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select";
+import { Tooltip, TooltipContent, TooltipTrigger } from "@/components/ui/tooltip";
+
+function apiErrorMessage(err: unknown, fallback: string): string {
+  return err instanceof AuthApiError ? err.message : fallback;
+}
+
+function customerName(customer: CustomerSummary): string {
+  return [customer.firstName, customer.lastName].filter(Boolean).join(" ");
+}
+
+function initialsOf(customer: CustomerSummary): string {
+  const from = customerName(customer) || customer.email;
+  return (
+    from
+      .split(/[@.\s]+/)
+      .filter(Boolean)
+      .slice(0, 2)
+      .map((part) => part[0]?.toUpperCase())
+      .join("") || "?"
+  );
+}
+
+export function CustomersPage() {
+  const ability = useAbility();
+  const canManage = ability.can(PERMISSIONS.customersManage, "permission");
+  const canStatus = ability.can(PERMISSIONS.customersStatus, "permission");
+
+  const [search, setSearch] = useState("");
+  const [searchKey] = useDebounce(search, 500);
+  const [status, setStatus] = useState<"" | "active" | "inactive">("");
+  const [sorting, setSorting] = useState<SortingState>([]);
+  const [pagination, setPagination] = useState<PaginationState>({ pageIndex: 0, pageSize: 20 });
+
+  const [confirmOpen, setConfirmOpen] = useState(false);
+  const [pendingCustomer, setPendingCustomer] = useState<CustomerSummary | null>(null);
+  const [pendingAction, setPendingAction] = useState<"status" | "delete" | null>(null);
+  const [pendingBusy, setPendingBusy] = useState(false);
+
+  const { data, isLoading, isError, error, refetch } = useQuery({
+    queryKey: ["customers-list", pagination.pageIndex, pagination.pageSize, searchKey, status],
+    queryFn: () =>
+      authClient.listCustomers({
+        search: searchKey || undefined,
+        page: pagination.pageIndex + 1,
+        limit: pagination.pageSize,
+        // The backend filter is `activeOnly` — one-directional — so "Active" filters server-side
+        // (correct totals) while "Inactive" has to filter the fetched page below.
+        activeOnly: status === "active" ? true : undefined,
+      }),
+    placeholderData: keepPreviousData,
+  });
+
+  const total = data?.meta.total ?? 0;
+  const pageCount = data?.meta.pageCount ?? 0;
+
+  const customers = useMemo(() => {
+    let items = data?.items ?? [];
+    if (status === "inactive") items = items.filter((c) => !c.isActive);
+    return items;
+  }, [data, status]);
+
+  function clearFilters() {
+    setSearch("");
+    setStatus("");
+    setPagination((p) => ({ ...p, pageIndex: 0 }));
+  }
+
+  function openStatusConfirm(customer: CustomerSummary) {
+    setPendingCustomer(customer);
+    setPendingAction("status");
+    setConfirmOpen(true);
+  }
+
+  function openDeleteConfirm(customer: CustomerSummary) {
+    setPendingCustomer(customer);
+    setPendingAction("delete");
+    setConfirmOpen(true);
+  }
+
+  async function confirmPendingAction() {
+    if (!pendingCustomer || !pendingAction) return;
+    setPendingBusy(true);
+    try {
+      if (pendingAction === "status") {
+        if (pendingCustomer.isActive) await authClient.deactivateCustomer(pendingCustomer.id);
+        else await authClient.activateCustomer(pendingCustomer.id);
+        toast.success(pendingCustomer.isActive ? "Customer deactivated." : "Customer activated.");
+      } else {
+        await authClient.deleteCustomer(pendingCustomer.id);
+        toast.success("Customer deleted.");
+      }
+      setConfirmOpen(false);
+      setPendingCustomer(null);
+      setPendingAction(null);
+      await refetch();
+    } catch (err) {
+      toast.error(apiErrorMessage(err, "That action failed. Try again."));
+    } finally {
+      setPendingBusy(false);
+    }
+  }
+
+  const columns = useMemo<ColumnDef<CustomerSummary>[]>(
+    () => [
+      {
+        id: "customer",
+        header: "Customer",
+        accessorFn: (customer) => customerName(customer) || customer.email,
+        cell: ({ row }) => {
+          const customer = row.original;
+          const name = customerName(customer);
+          return (
+            <Link to={`/customers/${customer.id}`} className="flex items-center gap-2 hover:underline">
+              <Avatar className="size-8">
+                {customer.photo && <AvatarImage src={customer.photo} alt="" />}
+                <AvatarFallback>{initialsOf(customer)}</AvatarFallback>
+              </Avatar>
+              <div className="flex flex-col">
+                <span className="font-medium">{name || customer.email}</span>
+                {name && <span className="text-xs text-muted-foreground">{customer.email}</span>}
+              </div>
+            </Link>
+          );
+        },
+      },
+      {
+        id: "username",
+        header: "Username",
+        accessorFn: (customer) => customer.username ?? "",
+        cell: ({ row }) => <span className="text-sm">{row.original.username || "—"}</span>,
+      },
+      {
+        id: "phone",
+        header: "Phone",
+        accessorFn: (customer) => customer.phone ?? "",
+        cell: ({ row }) => <span className="text-sm">{row.original.phone || "—"}</span>,
+      },
+      {
+        id: "dob",
+        header: "Date of birth",
+        accessorFn: (customer) => customer.dob ?? "",
+        cell: ({ row }) =>
+          row.original.dob ? (
+            <span className="text-xs text-muted-foreground">{format(new Date(row.original.dob), "dd MMM yyyy")}</span>
+          ) : (
+            <span className="text-xs text-muted-foreground">—</span>
+          ),
+      },
+      {
+        id: "gender",
+        header: "Gender",
+        accessorFn: (customer) => customer.gender ?? "",
+        cell: ({ row }) => <span className="text-sm capitalize">{row.original.gender || "—"}</span>,
+      },
+      {
+        id: "joined",
+        header: "Joined",
+        accessorFn: (customer) => customer.joinedDate,
+        cell: ({ row }) => <span className="text-xs text-muted-foreground">{format(new Date(row.original.joinedDate), "dd MMM yyyy")}</span>,
+      },
+      {
+        id: "emailVerified",
+        header: "Email verified",
+        accessorFn: (customer) => (customer.isEmailVerified ? "Yes" : "No"),
+        cell: ({ row }) => <Badge variant={row.original.isEmailVerified ? "success" : "outline"}>{row.original.isEmailVerified ? "Verified" : "Unverified"}</Badge>,
+      },
+      {
+        id: "phoneVerified",
+        header: "Phone verified",
+        accessorFn: (customer) => (customer.isPhoneVerified ? "Yes" : "No"),
+        cell: ({ row }) => <Badge variant={row.original.isPhoneVerified ? "success" : "outline"}>{row.original.isPhoneVerified ? "Verified" : "Unverified"}</Badge>,
+      },
+      {
+        id: "status",
+        header: "Status",
+        accessorFn: (customer) => (customer.isActive ? "Active" : "Inactive"),
+        cell: ({ row }) => {
+          const customer = row.original;
+          return (
+            <Tooltip>
+              <TooltipTrigger asChild>
+                <button type="button" disabled={!canStatus} className="disabled:cursor-not-allowed disabled:opacity-60" onClick={() => openStatusConfirm(customer)}>
+                  <Badge variant={customer.isActive ? "success" : "destructive"}>{customer.isActive ? "Active" : "Inactive"}</Badge>
+                </button>
+              </TooltipTrigger>
+              <TooltipContent>
+                {canStatus
+                  ? customer.isActive
+                    ? "Deactivate this customer"
+                    : "Activate this customer"
+                  : `You need the "${PERMISSIONS.customersStatus}" permission to do this.`}
+              </TooltipContent>
+            </Tooltip>
+          );
+        },
+      },
+      {
+        id: "created",
+        header: "Created",
+        accessorFn: (customer) => customer.createdAt,
+        cell: ({ row }) => <span className="text-xs text-muted-foreground">{format(new Date(row.original.createdAt), "dd MMM yyyy")}</span>,
+      },
+      {
+        id: "actions",
+        header: "Actions",
+        enableSorting: false,
+        cell: ({ row }) => {
+          const customer = row.original;
+          return (
+            <div className="flex justify-end items-center gap-1.5">
+              <Tooltip>
+                <TooltipTrigger asChild>
+                  <Link to={`/customers/${customer.id}`} className={cn(buttonVariants({ variant: "outline", size: "icon" }))}>
+                    <EyeIcon />
+                  </Link>
+                </TooltipTrigger>
+                <TooltipContent>View details</TooltipContent>
+              </Tooltip>
+              <Tooltip>
+                <TooltipTrigger asChild>
+                  <Link
+                    to={`/customers/${customer.id}/edit`}
+                    aria-disabled={!canManage}
+                    className={cn(buttonVariants({ variant: "outline", size: "icon" }), !canManage && "pointer-events-none opacity-50")}
+                  >
+                    <PencilIcon />
+                  </Link>
+                </TooltipTrigger>
+                <TooltipContent>{canManage ? "Edit customer" : `You need the "${PERMISSIONS.customersManage}" permission to do this.`}</TooltipContent>
+              </Tooltip>
+              <Tooltip>
+                <TooltipTrigger asChild>
+                  <Button size="icon" variant="outline" disabled={!canStatus} onClick={() => openStatusConfirm(customer)}>
+                    <PowerIcon />
+                  </Button>
+                </TooltipTrigger>
+                <TooltipContent>
+                  {canStatus
+                    ? customer.isActive
+                      ? "Deactivate this customer"
+                      : "Activate this customer"
+                    : `You need the "${PERMISSIONS.customersStatus}" permission to do this.`}
+                </TooltipContent>
+              </Tooltip>
+              <Tooltip>
+                <TooltipTrigger asChild>
+                  <Button size="icon" variant="outline" disabled={!canManage} onClick={() => openDeleteConfirm(customer)}>
+                    <Trash2Icon />
+                  </Button>
+                </TooltipTrigger>
+                <TooltipContent>{canManage ? "Delete customer" : `You need the "${PERMISSIONS.customersManage}" permission to do this.`}</TooltipContent>
+              </Tooltip>
+            </div>
+          );
+        },
+      },
+    ],
+    [canManage, canStatus],
+  );
+
+  const table = useReactTable({
+    data: customers,
+    columns,
+    pageCount: pageCount || -1,
+    state: { sorting, pagination },
+    onSortingChange: setSorting,
+    onPaginationChange: setPagination,
+    getCoreRowModel: getCoreRowModel(),
+    getSortedRowModel: getSortedRowModel(),
+    manualPagination: true,
+    manualFiltering: true,
+  });
+
+  return (
+    <div className="flex flex-col gap-4">
+      <Breadcrumb items={[{ title: "Customers", href: "/customers" }]} />
+
+      <AlertModal
+        isOpen={confirmOpen}
+        onClose={() => setConfirmOpen(false)}
+        onConfirm={confirmPendingAction}
+        loading={pendingBusy}
+        description={
+          pendingAction === "status"
+            ? pendingCustomer?.isActive
+              ? "This deactivates the customer — they stop appearing in active listings until reactivated."
+              : "This reactivates the customer, immediately."
+            : "This soft-deletes the customer: they stop appearing in listings, but the row is kept for audit purposes."
+        }
+      />
+
+      <Card>
+        <CardHeader className="flex flex-row items-center justify-between">
+          <CardTitle>Customers</CardTitle>
+          {canManage ? (
+            <Link to="/customers/new" className={cn(buttonVariants({ size: "sm" }))}>
+              <PlusIcon />
+              Add customer
+            </Link>
+          ) : null}
+        </CardHeader>
+        <CardContent className="flex flex-col gap-4">
+          {isError ? <p className="text-sm text-destructive">{apiErrorMessage(error, "Couldn't load customers. Try again.")}</p> : null}
+
+          <div className="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4">
+            <Input
+              placeholder="Search customers…"
+              value={search}
+              onChange={(e) => {
+                setSearch(e.target.value);
+                setPagination((p) => ({ ...p, pageIndex: 0 }));
+              }}
+            />
+            <Select value={status || "all"} onValueChange={(value) => setStatus(value === "all" ? "" : (value as "active" | "inactive"))}>
+              <SelectTrigger className="w-full">
+                <SelectValue placeholder="Select status" />
+              </SelectTrigger>
+              <SelectContent>
+                <SelectItem value="all">All statuses</SelectItem>
+                <SelectItem value="active">Active</SelectItem>
+                <SelectItem value="inactive">Inactive</SelectItem>
+              </SelectContent>
+            </Select>
+            <Button variant="outline" disabled={!search && !status} onClick={clearFilters}>
+              Clear
+            </Button>
+          </div>
+
+          <div className="flex flex-col items-start justify-between gap-2 sm:flex-row sm:items-center">
+            <p className="text-sm text-muted-foreground">
+              Showing {customers.length} of {total} results
+            </p>
+            <DropdownMenu>
+              <DropdownMenuTrigger asChild>
+                <Button variant="outline" size="sm">
+                  Columns <ChevronDownIcon className="ml-1 size-3.5" />
+                </Button>
+              </DropdownMenuTrigger>
+              <DropdownMenuContent align="end">
+                {table
+                  .getAllColumns()
+                  .filter((column) => column.getCanHide())
+                  .map((column) => (
+                    <DropdownMenuCheckboxItem key={column.id} className="capitalize" checked={column.getIsVisible()} onCheckedChange={(value) => column.toggleVisibility(!!value)}>
+                      {column.id}
+                    </DropdownMenuCheckboxItem>
+                  ))}
+              </DropdownMenuContent>
+            </DropdownMenu>
+          </div>
+
+          {isLoading ? (
+            <TableSkeletonLoader
+              columns={[
+                { header: "Customer", skeletonType: "avatar" },
+                { header: "Username", skeletonType: "text", skeletonWidth: "w-24" },
+                { header: "Phone", skeletonType: "text", skeletonWidth: "w-24" },
+                { header: "Date of birth", skeletonType: "text", skeletonWidth: "w-24" },
+                { header: "Gender", skeletonType: "text", skeletonWidth: "w-16" },
+                { header: "Joined", skeletonType: "text", skeletonWidth: "w-24" },
+                { header: "Email verified", skeletonType: "badge" },
+                { header: "Phone verified", skeletonType: "badge" },
+                { header: "Status", width: "w-[100px]", skeletonType: "button" },
+                { header: "Created", skeletonType: "text", skeletonWidth: "w-24" },
+                { header: "Actions", width: "w-[160px]", skeletonType: "actions", skeletonCount: 3 },
+              ]}
+              rows={pagination.pageSize > 10 ? 10 : pagination.pageSize}
+            />
+          ) : customers.length === 0 ? (
+            <div className="flex flex-col items-center justify-center py-12 text-center">
+              <p className="text-lg text-muted-foreground">No data found</p>
+              <p className="mt-2 text-sm text-muted-foreground">Try adjusting your search or filters</p>
+            </div>
+          ) : (
+            <DataTable columns={columns} data={customers} total={total} table={table} onPaginationChange={setPagination} />
+          )}
+        </CardContent>
+      </Card>
+    </div>
+  );
+}

package/registry/admin-apps/react/variants/base/src/pages/DashboardPage.tsx

@@ -0,0 +1,190 @@
+import { RadioIcon } from "lucide-react";
+import { useEffect, useState } from "react";
+import { Link } from "react-router-dom";
+import { AuthApiError, type AuditLogEntry } from "@simple-auth-kit/auth-client";
+import { Badge } from "@/components/ui/badge";
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card";
+import { useLiveAuditFeed, type LiveFeedStatus } from "@/hooks/use-live-audit-feed";
+import { PERMISSIONS, useAbility } from "@/lib/ability";
+import { authClient } from "@/lib/auth-client";
+import { cn } from "@/lib/cn";
+
+const liveStatusStyles: Record<LiveFeedStatus, { dot: string; label: string }> = {
+  connecting: { dot: "bg-amber-500", label: "Connecting" },
+  connected: { dot: "bg-emerald-500", label: "Live" },
+  disconnected: { dot: "bg-red-500", label: "Offline" },
+};
+
+function LiveStatusBadge({ status }: { status: LiveFeedStatus }) {
+  const { dot, label } = liveStatusStyles[status];
+  return (
+    <Badge variant="outline" className="gap-1.5">
+      <span className={cn("size-2 rounded-full", dot, status === "connected" && "animate-pulse")} />
+      {label}
+    </Badge>
+  );
+}
+
+/**
+ * The console's front door. Cards are individually permission-gated so a low-privilege user sees
+ * fewer of them rather than hitting a wall — that's also why this route isn't wrapped in
+ * `RequirePermission` in App.tsx.
+ */
+export function DashboardPage() {
+  const ability = useAbility();
+  const canReadUsers = ability.can(PERMISSIONS.usersRead, "permission");
+  const canManageRoles = ability.can(PERMISSIONS.rolesManage, "permission");
+  const canReadPermissions = ability.can(PERMISSIONS.permissionsRead, "permission");
+  const canReadAuditLog = ability.can(PERMISSIONS.auditLogRead, "permission");
+  const { status: liveStatus, entries: liveEntries } = useLiveAuditFeed(canReadAuditLog);
+
+  const [userCount, setUserCount] = useState<number | null>(null);
+  const [roleCount, setRoleCount] = useState<number | null>(null);
+  const [permissionCount, setPermissionCount] = useState<number | null>(null);
+  const [recentActivity, setRecentActivity] = useState<AuditLogEntry[]>([]);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    let cancelled = false;
+
+    async function load() {
+      try {
+        if (canReadUsers) {
+          const users = await authClient.listUsers({ limit: 1 });
+          if (!cancelled) setUserCount(users.meta.total);
+        }
+        if (canManageRoles) {
+          const roles = await authClient.listRoles();
+          if (!cancelled) setRoleCount(roles.length);
+        }
+        if (canReadPermissions) {
+          const permissions = await authClient.listPermissions();
+          if (!cancelled) setPermissionCount(permissions.length);
+        }
+        if (canReadAuditLog) {
+          const audit = await authClient.listAuditLog({ limit: 5 });
+          if (!cancelled) setRecentActivity(audit.items);
+        }
+      } catch (err) {
+        if (!cancelled) {
+          setError(
+            err instanceof AuthApiError ? err.message : "Couldn't load dashboard data. Check that the backend is running, then try again.",
+          );
+        }
+      }
+    }
+
+    void load();
+    return () => {
+      cancelled = true;
+    };
+  }, [canReadUsers, canManageRoles, canReadPermissions, canReadAuditLog]);
+
+  return (
+    <div className="flex flex-col gap-4">
+      <div>
+        <h1 className="text-2xl font-semibold">Dashboard</h1>
+        <p className="text-sm text-muted-foreground">An overview of this deployment.</p>
+      </div>
+
+      {error ? <p className="text-sm text-destructive">{error}</p> : null}
+
+      <div className="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-3">
+        {canReadUsers ? (
+          <Card>
+            <CardHeader>
+              <CardDescription>Users</CardDescription>
+              <CardTitle className="text-3xl">{userCount ?? "—"}</CardTitle>
+            </CardHeader>
+            <CardContent className="text-sm text-muted-foreground">
+              <Link to="/users" className="font-medium text-primary underline underline-offset-2">
+                On this deployment →
+              </Link>
+            </CardContent>
+          </Card>
+        ) : null}
+        {canManageRoles ? (
+          <Card>
+            <CardHeader>
+              <CardDescription>Roles</CardDescription>
+              <CardTitle className="text-3xl">{roleCount ?? "—"}</CardTitle>
+            </CardHeader>
+            <CardContent className="text-sm text-muted-foreground">Defined for this deployment</CardContent>
+          </Card>
+        ) : null}
+        {canReadPermissions ? (
+          <Card>
+            <CardHeader>
+              <CardDescription>Permissions</CardDescription>
+              <CardTitle className="text-3xl">{permissionCount ?? "—"}</CardTitle>
+            </CardHeader>
+            <CardContent className="text-sm text-muted-foreground">In the capability catalog</CardContent>
+          </Card>
+        ) : null}
+      </div>
+
+      {canReadAuditLog ? (
+        <Card>
+          <CardHeader className="flex flex-row items-center justify-between">
+            <div>
+              <CardTitle>Recent activity</CardTitle>
+              <CardDescription>The latest entries from the audit log.</CardDescription>
+            </div>
+            <Link to="/audit-log" className="text-sm font-medium text-primary underline underline-offset-2">
+              View all →
+            </Link>
+          </CardHeader>
+          <CardContent>
+            {recentActivity.length === 0 ? (
+              <p className="text-sm text-muted-foreground">No activity yet.</p>
+            ) : (
+              <ul className="flex flex-col gap-2">
+                {recentActivity.map((entry) => (
+                  <li key={entry.id} className="flex items-center justify-between gap-2 rounded-lg border border-border px-3 py-2 text-sm">
+                    <div className="flex items-center gap-2">
+                      <Badge variant="outline">{entry.action}</Badge>
+                      <span>{entry.name}</span>
+                    </div>
+                    <span className="text-xs text-muted-foreground">{new Date(entry.createdAt).toLocaleString()}</span>
+                  </li>
+                ))}
+              </ul>
+            )}
+          </CardContent>
+        </Card>
+      ) : null}
+
+      {canReadAuditLog ? (
+        <Card>
+          <CardHeader className="flex flex-row items-center justify-between">
+            <div className="flex items-center gap-2">
+              <RadioIcon className="size-4 text-muted-foreground" />
+              <div>
+                <CardTitle>Live activity</CardTitle>
+                <CardDescription>Audit events as they happen, streamed from the backend.</CardDescription>
+              </div>
+            </div>
+            <LiveStatusBadge status={liveStatus} />
+          </CardHeader>
+          <CardContent>
+            {liveEntries.length === 0 ? (
+              <p className="text-sm text-muted-foreground">{liveStatus === "connected" ? "Waiting for activity…" : "No live events."}</p>
+            ) : (
+              <ul className="flex flex-col gap-2">
+                {liveEntries.map((entry) => (
+                  <li key={entry.id} className="flex items-center justify-between gap-2 rounded-lg border border-border px-3 py-2 text-sm">
+                    <div className="flex items-center gap-2">
+                      <Badge variant="outline">{entry.action}</Badge>
+                      <span>{entry.name}</span>
+                    </div>
+                    <span className="text-xs text-muted-foreground">{new Date(entry.createdAt).toLocaleTimeString()}</span>
+                  </li>
+                ))}
+              </ul>
+            )}
+          </CardContent>
+        </Card>
+      ) : null}
+    </div>
+  );
+}