nl-d365boilerplate-vite 1.0.0

package/src/hooks/useAccounts.ts

@@ -0,0 +1,194 @@
+import { useState, useCallback } from "react";
+import { useDataverse } from "@/hooks/useDataverse";
+
+export interface Account {
+  accountid?: string;
+  name?: string;
+  emailaddress1?: string;
+  telephone1?: string;
+  websiteurl?: string;
+  address1_city?: string;
+  createdon?: string;
+}
+
+export const useAccounts = () => {
+  const { api, isReady } = useDataverse();
+  const [accounts, setAccounts] = useState<Account[]>([]);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  // Retrieve Multiple Accounts
+  const fetchAccounts = useCallback(async () => {
+    if (!api || !isReady) return;
+
+    setLoading(true);
+    setError(null);
+
+    try {
+      const response = await api.retrieveMultiple({
+        collection: "accounts",
+        select: [
+          "accountid",
+          "name",
+          "emailaddress1",
+          "telephone1",
+          "websiteurl",
+          "address1_city",
+          "createdon",
+        ],
+        filter: "statecode eq 0",
+        orderBy: ["name asc"],
+        maxPageSize: 100,
+      });
+
+      setAccounts(response?.value || []);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : "Failed to fetch accounts");
+    } finally {
+      setLoading(false);
+    }
+  }, [api, isReady]);
+
+  // Retrieve Single Account
+  const getAccount = useCallback(
+    async (accountId: string): Promise<Account | null> => {
+      if (!api || !isReady || !accountId) return null;
+
+      try {
+        setError(null);
+        const response = await api.retrieve({
+          collection: "accounts",
+          key: accountId,
+          select: [
+            "accountid",
+            "name",
+            "emailaddress1",
+            "telephone1",
+            "websiteurl",
+            "address1_city",
+            "createdon",
+          ],
+        });
+
+        return response as Account;
+      } catch (err) {
+        setError(
+          err instanceof Error ? err.message : "Failed to retrieve account",
+        );
+        return null;
+      }
+    },
+    [api, isReady],
+  );
+
+  // Create Account
+  const createAccount = useCallback(
+    async (accountData: Partial<Account>): Promise<string | null> => {
+      if (!api || !isReady || !accountData.name) return null;
+
+      setLoading(true);
+      setError(null);
+
+      try {
+        const response = await api.create({
+          collection: "accounts",
+          data: accountData,
+        });
+
+        // Refresh the accounts list
+        await fetchAccounts();
+
+        return response as string;
+      } catch (err) {
+        setError(
+          err instanceof Error ? err.message : "Failed to create account",
+        );
+        return null;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [api, isReady, fetchAccounts],
+  );
+
+  // Update Account
+  const updateAccount = useCallback(
+    async (accountId: string, updates: Partial<Account>): Promise<boolean> => {
+      if (!api || !isReady || !accountId) return false;
+
+      setLoading(true);
+      setError(null);
+
+      try {
+        await api.update({
+          collection: "accounts",
+          key: accountId,
+          data: updates,
+        });
+
+        // Refresh the accounts list
+        await fetchAccounts();
+
+        return true;
+      } catch (err) {
+        setError(
+          err instanceof Error ? err.message : "Failed to update account",
+        );
+        return false;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [api, isReady, fetchAccounts],
+  );
+
+  // Delete Account
+  const deleteAccount = useCallback(
+    async (accountId: string): Promise<boolean> => {
+      if (!api || !isReady || !accountId) return false;
+
+      setLoading(true);
+      setError(null);
+
+      try {
+        await api.deleteRecord({
+          collection: "accounts",
+          key: accountId,
+        });
+
+        // Refresh the accounts list
+        await fetchAccounts();
+
+        return true;
+      } catch (err) {
+        setError(
+          err instanceof Error ? err.message : "Failed to delete account",
+        );
+        return false;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [api, isReady, fetchAccounts],
+  );
+
+  const clearError = useCallback(() => {
+    setError(null);
+  }, []);
+
+  return {
+    // State
+    accounts,
+    loading,
+    error,
+    isReady,
+
+    // Actions
+    fetchAccounts,
+    getAccount,
+    createAccount,
+    updateAccount,
+    deleteAccount,
+    clearError,
+  };
+};

package/src/hooks/useDataverse.ts

@@ -0,0 +1,11 @@
+import { useContext } from "react";
+
+import { DataverseContext } from "@/contexts/dataverse-context";
+
+export const useDataverse = () => {
+  const context = useContext(DataverseContext);
+  if (!context) {
+    throw new Error("useDataverse must be used within a DataverseProvider");
+  }
+  return context;
+};

package/src/hooks/useNavigation.ts

@@ -0,0 +1,41 @@
+import { useCallback, useContext } from "react";
+
+import { type PageConfig, PAGES } from "@/config/pages.config";
+import { NavigationContext } from "@/contexts/navigation-context";
+
+export function useNavigation() {
+  const context = useContext(NavigationContext);
+
+  if (!context) {
+    throw new Error("useNavigation must be used within a NavigationProvider");
+  }
+
+  const { currentPage, navigate: navigateToPage, canGoBack, goBack } = context;
+
+  const navigate = useCallback(
+    (pageId: string) => {
+      const page = PAGES[pageId];
+      if (page) {
+        navigateToPage(page);
+      } else {
+        console.error(`Page "${pageId}" not found in page configuration`);
+      }
+    },
+    [navigateToPage],
+  );
+
+  const navigateTo = useCallback(
+    (page: PageConfig) => {
+      navigateToPage(page);
+    },
+    [navigateToPage],
+  );
+
+  return {
+    currentPage,
+    navigate,
+    navigateTo,
+    canGoBack,
+    goBack,
+  };
+}

package/src/index.css

@@ -0,0 +1,147 @@
+@import "tailwindcss";
+@import "tw-animate-css";
+
+@custom-variant dark (&:is(.dark *));
+
+@theme inline {
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+  --radius-2xl: calc(var(--radius) + 8px);
+  --radius-3xl: calc(var(--radius) + 12px);
+  --radius-4xl: calc(var(--radius) + 16px);
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --color-chart-1: var(--chart-1);
+  --color-chart-2: var(--chart-2);
+  --color-chart-3: var(--chart-3);
+  --color-chart-4: var(--chart-4);
+  --color-chart-5: var(--chart-5);
+  --color-sidebar: var(--sidebar);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-ring: var(--sidebar-ring);
+  --color-code-highlight: var(--code-highlight);
+  --color-code-border: var(--code-border);
+  --color-code-muted: var(--code-muted);
+  --color-code-foreground: var(--code-foreground);
+  --color-code-bg: var(--code-bg);
+  --color-success-foreground: var(--success-foreground);
+  --color-success: var(--success);
+  --color-destructive-foreground: var(--destructive-foreground);
+}
+
+:root {
+  --radius: 0.8rem;
+  --background: oklch(0.985 0.002 265);
+  --foreground: oklch(0.145 0.025 265);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.145 0.025 265);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0.025 265);
+  --primary: oklch(0.455 0.188 262);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.965 0.008 265);
+  --secondary-foreground: oklch(0.205 0.025 265);
+  --muted: oklch(0.965 0.008 265);
+  --muted-foreground: oklch(0.485 0.022 265);
+  --accent: oklch(0.965 0.008 265);
+  --accent-foreground: oklch(0.205 0.025 265);
+  --destructive: oklch(0.575 0.195 27);
+  --border: oklch(0.915 0.008 265);
+  --input: oklch(0.915 0.008 265);
+  --ring: oklch(0.455 0.188 262);
+  --chart-1: oklch(0.455 0.188 262);
+  --chart-2: oklch(0.585 0.155 200);
+  --chart-3: oklch(0.585 0.155 340);
+  --chart-4: oklch(0.625 0.175 145);
+  --chart-5: oklch(0.625 0.175 38);
+  --sidebar: oklch(0.975 0.005 265);
+  --sidebar-foreground: oklch(0.145 0.025 265);
+  --sidebar-primary: oklch(0.455 0.188 262);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.965 0.008 265);
+  --sidebar-accent-foreground: oklch(0.205 0.025 265);
+  --sidebar-border: oklch(0.915 0.008 265);
+  --sidebar-ring: oklch(0.455 0.188 262);
+  --destructive-foreground: oklch(0.985 0 0);
+  --success: oklch(0.625 0.175 145);
+  --success-foreground: oklch(0.985 0 0);
+  --code-bg: oklch(0.97 0 0);
+  --code-foreground: oklch(0.205 0.025 265);
+  --code-muted: oklch(0.552 0.016 285.938);
+  --code-border: oklch(0.92 0 0);
+  --code-highlight: oklch(0.95 0 0);
+}
+
+.dark {
+  --background: oklch(0.115 0.018 265);
+  --foreground: oklch(0.965 0.008 265);
+  --card: oklch(0.145 0.022 265);
+  --card-foreground: oklch(0.965 0.008 265);
+  --popover: oklch(0.145 0.022 265);
+  --popover-foreground: oklch(0.965 0.008 265);
+  --primary: oklch(0.625 0.215 262);
+  --primary-foreground: oklch(0.115 0.018 265);
+  --secondary: oklch(0.205 0.028 265);
+  --secondary-foreground: oklch(0.965 0.008 265);
+  --muted: oklch(0.205 0.028 265);
+  --muted-foreground: oklch(0.625 0.018 265);
+  --accent: oklch(0.205 0.028 265);
+  --accent-foreground: oklch(0.965 0.008 265);
+  --destructive: oklch(0.545 0.195 27);
+  --border: oklch(0.245 0.028 265);
+  --input: oklch(0.245 0.028 265);
+  --ring: oklch(0.625 0.215 262);
+  --chart-1: oklch(0.625 0.215 262);
+  --chart-2: oklch(0.685 0.155 200);
+  --chart-3: oklch(0.685 0.155 340);
+  --chart-4: oklch(0.725 0.175 145);
+  --chart-5: oklch(0.725 0.175 38);
+  --sidebar: oklch(0.125 0.02 265);
+  --sidebar-foreground: oklch(0.965 0.008 265);
+  --sidebar-primary: oklch(0.625 0.215 262);
+  --sidebar-primary-foreground: oklch(0.965 0.008 265);
+  --sidebar-accent: oklch(0.205 0.028 265);
+  --sidebar-accent-foreground: oklch(0.965 0.008 265);
+  --sidebar-border: oklch(0.245 0.028 265);
+  --sidebar-ring: oklch(0.625 0.215 262);
+  --destructive-foreground: oklch(0.985 0 0);
+  --success: oklch(0.725 0.175 145);
+  --success-foreground: oklch(0.115 0.018 265);
+  --code-bg: oklch(0.18 0 0);
+  --code-foreground: oklch(0.93 0 0);
+  --code-muted: oklch(0.55 0 0);
+  --code-border: oklch(0.3 0 0);
+  --code-highlight: oklch(0.28 0 0);
+}
+
+@layer base {
+  * {
+    @apply border-border outline-ring/50;
+  }
+  body {
+    @apply bg-background text-foreground;
+  }
+}

package/src/lib/nav-items.ts

@@ -0,0 +1,25 @@
+import { BookOpen01Icon, Home01Icon, TestTube01Icon } from "hugeicons-react";
+
+export interface NavItem {
+  label: string;
+  pageId: string;
+  icon: React.ElementType;
+}
+
+export const navItems: NavItem[] = [
+  {
+    label: "Home",
+    pageId: "home",
+    icon: Home01Icon,
+  },
+  {
+    label: "Documentation",
+    pageId: "documentation",
+    icon: BookOpen01Icon,
+  },
+  {
+    label: "Demo",
+    pageId: "demo",
+    icon: TestTube01Icon,
+  },
+];

package/src/lib/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx"
+import { twMerge } from "tailwind-merge"
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/src/main.tsx

@@ -0,0 +1,12 @@
+import "./index.css";
+
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+
+import App from "./App.tsx";
+
+createRoot(document.getElementById("root")!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);