@contractspec/example.saas-boilerplate 1.57.0 → 1.59.0

package/dist/browser/ui/SaasProjectList.js

@@ -0,0 +1,162 @@
+// src/ui/hooks/useProjectList.ts
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+function useProjectList(options = {}) {
+  const { handlers, projectId } = useTemplateRuntime();
+  const { saas } = handlers;
+  const [data, setData] = useState(null);
+  const [subscription, setSubscription] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const [page, setPage] = useState(1);
+  const fetchData = useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const [projectsResult, subscriptionResult] = await Promise.all([
+        saas.listProjects({
+          projectId,
+          status: options.status === "all" ? undefined : options.status,
+          search: options.search,
+          limit: options.limit ?? 20,
+          offset: (page - 1) * (options.limit ?? 20)
+        }),
+        saas.getSubscription({ projectId })
+      ]);
+      setData({
+        items: projectsResult.items,
+        total: projectsResult.total
+      });
+      setSubscription(subscriptionResult);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Unknown error"));
+    } finally {
+      setLoading(false);
+    }
+  }, [saas, projectId, options.status, options.search, options.limit, page]);
+  useEffect(() => {
+    fetchData();
+  }, [fetchData]);
+  const stats = useMemo(() => {
+    if (!data)
+      return null;
+    const items = data.items;
+    return {
+      total: data.total,
+      activeCount: items.filter((p) => p.status === "ACTIVE").length,
+      draftCount: items.filter((p) => p.status === "DRAFT").length,
+      projectLimit: 10,
+      usagePercent: Math.min(data.total / 10 * 100, 100)
+    };
+  }, [data]);
+  return {
+    data,
+    subscription,
+    loading,
+    error,
+    stats,
+    page,
+    refetch: fetchData,
+    nextPage: () => setPage((p) => p + 1),
+    prevPage: () => page > 1 && setPage((p) => p - 1)
+  };
+}
+
+// src/ui/SaasProjectList.tsx
+import {
+  StatCard,
+  StatCardGroup,
+  StatusChip,
+  EntityCard,
+  EmptyState,
+  LoaderBlock,
+  ErrorState,
+  Button
+} from "@contractspec/lib.design-system";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+function getStatusTone(status) {
+  switch (status) {
+    case "ACTIVE":
+      return "success";
+    case "DRAFT":
+      return "neutral";
+    case "ARCHIVED":
+      return "danger";
+    default:
+      return "neutral";
+  }
+}
+function SaasProjectList({
+  onProjectClick,
+  onCreateProject
+}) {
+  const { data, loading, error, stats, refetch } = useProjectList();
+  if (loading && !data) {
+    return /* @__PURE__ */ jsxDEV(LoaderBlock, {
+      label: "Loading projects..."
+    }, undefined, false, undefined, this);
+  }
+  if (error) {
+    return /* @__PURE__ */ jsxDEV(ErrorState, {
+      title: "Failed to load projects",
+      description: error.message,
+      onRetry: refetch,
+      retryLabel: "Retry"
+    }, undefined, false, undefined, this);
+  }
+  if (!data?.items.length) {
+    return /* @__PURE__ */ jsxDEV(EmptyState, {
+      title: "No projects found",
+      description: "Create your first project to get started.",
+      primaryAction: onCreateProject ? /* @__PURE__ */ jsxDEV(Button, {
+        onPress: onCreateProject,
+        children: "Create Project"
+      }, undefined, false, undefined, this) : undefined
+    }, undefined, false, undefined, this);
+  }
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "space-y-6",
+    children: [
+      stats && /* @__PURE__ */ jsxDEV(StatCardGroup, {
+        children: [
+          /* @__PURE__ */ jsxDEV(StatCard, {
+            label: "Total Projects",
+            value: stats.total.toString()
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(StatCard, {
+            label: "Active",
+            value: stats.activeCount.toString()
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(StatCard, {
+            label: "Draft",
+            value: stats.draftCount.toString()
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "grid gap-4 md:grid-cols-2 lg:grid-cols-3",
+        children: data.items.map((project) => /* @__PURE__ */ jsxDEV(EntityCard, {
+          cardTitle: project.name,
+          cardSubtitle: project.tier,
+          meta: /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground text-sm",
+            children: project.description
+          }, undefined, false, undefined, this),
+          chips: /* @__PURE__ */ jsxDEV(StatusChip, {
+            tone: getStatusTone(project.status),
+            label: project.status
+          }, undefined, false, undefined, this),
+          footer: /* @__PURE__ */ jsxDEV("span", {
+            className: "text-muted-foreground text-xs",
+            children: project.updatedAt.toLocaleDateString()
+          }, undefined, false, undefined, this),
+          onClick: onProjectClick ? () => onProjectClick(project.id) : undefined
+        }, project.id, false, undefined, this))
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  SaasProjectList
+};

package/dist/browser/ui/SaasSettingsPanel.js

@@ -0,0 +1,145 @@
+// src/ui/SaasSettingsPanel.tsx
+import { useState } from "react";
+import { Button } from "@contractspec/lib.design-system";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+function SaasSettingsPanel() {
+  const [orgName, setOrgName] = useState("Demo Organization");
+  const [timezone, setTimezone] = useState("UTC");
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "space-y-6",
+    children: [
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "border-border bg-card rounded-xl border p-6",
+        children: [
+          /* @__PURE__ */ jsxDEV("h3", {
+            className: "mb-4 text-lg font-semibold",
+            children: "Organization Settings"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "space-y-4",
+            children: [
+              /* @__PURE__ */ jsxDEV("div", {
+                children: [
+                  /* @__PURE__ */ jsxDEV("label", {
+                    htmlFor: "setting-org-name",
+                    className: "block text-sm font-medium",
+                    children: "Organization Name"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV("input", {
+                    id: "setting-org-name",
+                    type: "text",
+                    value: orgName,
+                    onChange: (e) => setOrgName(e.target.value),
+                    className: "border-input bg-background mt-1 block w-full rounded-md border px-3 py-2"
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV("div", {
+                children: [
+                  /* @__PURE__ */ jsxDEV("label", {
+                    htmlFor: "setting-timezone",
+                    className: "block text-sm font-medium",
+                    children: "Default Timezone"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV("select", {
+                    id: "setting-timezone",
+                    value: timezone,
+                    onChange: (e) => setTimezone(e.target.value),
+                    className: "border-input bg-background mt-1 block w-full rounded-md border px-3 py-2",
+                    children: [
+                      /* @__PURE__ */ jsxDEV("option", {
+                        value: "UTC",
+                        children: "UTC"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV("option", {
+                        value: "America/New_York",
+                        children: "America/New_York"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV("option", {
+                        value: "Europe/London",
+                        children: "Europe/London"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV("option", {
+                        value: "Asia/Tokyo",
+                        children: "Asia/Tokyo"
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "mt-6",
+            children: /* @__PURE__ */ jsxDEV(Button, {
+              variant: "default",
+              children: "Save Changes"
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "border-border bg-card rounded-xl border p-6",
+        children: [
+          /* @__PURE__ */ jsxDEV("h3", {
+            className: "mb-4 text-lg font-semibold",
+            children: "Notifications"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "space-y-3",
+            children: [
+              { label: "Email notifications", defaultChecked: true },
+              { label: "Usage alerts", defaultChecked: true },
+              { label: "Weekly digest", defaultChecked: false }
+            ].map((item) => /* @__PURE__ */ jsxDEV("label", {
+              className: "flex items-center gap-3",
+              children: [
+                /* @__PURE__ */ jsxDEV("input", {
+                  type: "checkbox",
+                  defaultChecked: item.defaultChecked,
+                  className: "border-input h-4 w-4 rounded"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV("span", {
+                  className: "text-sm",
+                  children: item.label
+                }, undefined, false, undefined, this)
+              ]
+            }, item.label, true, undefined, this))
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "rounded-xl border border-red-200 bg-red-50 p-6 dark:border-red-900 dark:bg-red-950/20",
+        children: [
+          /* @__PURE__ */ jsxDEV("h3", {
+            className: "mb-2 text-lg font-semibold text-red-700 dark:text-red-400",
+            children: "Danger Zone"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "mb-4 text-sm text-red-600 dark:text-red-300",
+            children: "These actions are irreversible. Please proceed with caution."
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "flex gap-3",
+            children: [
+              /* @__PURE__ */ jsxDEV(Button, {
+                variant: "secondary",
+                size: "sm",
+                children: "Export Data"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV(Button, {
+                variant: "secondary",
+                size: "sm",
+                children: "Delete Organization"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  SaasSettingsPanel
+};

package/dist/browser/ui/hooks/index.js

@@ -0,0 +1,159 @@
+// src/ui/hooks/useProjectList.ts
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+function useProjectList(options = {}) {
+  const { handlers, projectId } = useTemplateRuntime();
+  const { saas } = handlers;
+  const [data, setData] = useState(null);
+  const [subscription, setSubscription] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const [page, setPage] = useState(1);
+  const fetchData = useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const [projectsResult, subscriptionResult] = await Promise.all([
+        saas.listProjects({
+          projectId,
+          status: options.status === "all" ? undefined : options.status,
+          search: options.search,
+          limit: options.limit ?? 20,
+          offset: (page - 1) * (options.limit ?? 20)
+        }),
+        saas.getSubscription({ projectId })
+      ]);
+      setData({
+        items: projectsResult.items,
+        total: projectsResult.total
+      });
+      setSubscription(subscriptionResult);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Unknown error"));
+    } finally {
+      setLoading(false);
+    }
+  }, [saas, projectId, options.status, options.search, options.limit, page]);
+  useEffect(() => {
+    fetchData();
+  }, [fetchData]);
+  const stats = useMemo(() => {
+    if (!data)
+      return null;
+    const items = data.items;
+    return {
+      total: data.total,
+      activeCount: items.filter((p) => p.status === "ACTIVE").length,
+      draftCount: items.filter((p) => p.status === "DRAFT").length,
+      projectLimit: 10,
+      usagePercent: Math.min(data.total / 10 * 100, 100)
+    };
+  }, [data]);
+  return {
+    data,
+    subscription,
+    loading,
+    error,
+    stats,
+    page,
+    refetch: fetchData,
+    nextPage: () => setPage((p) => p + 1),
+    prevPage: () => page > 1 && setPage((p) => p - 1)
+  };
+}
+
+// src/ui/hooks/useProjectMutations.ts
+import { useCallback as useCallback2, useState as useState2 } from "react";
+import { useTemplateRuntime as useTemplateRuntime2 } from "@contractspec/lib.example-shared-ui";
+function useProjectMutations(options = {}) {
+  const { handlers, projectId } = useTemplateRuntime2();
+  const { saas } = handlers;
+  const [createState, setCreateState] = useState2({
+    loading: false,
+    error: null,
+    data: null
+  });
+  const [updateState, setUpdateState] = useState2({
+    loading: false,
+    error: null,
+    data: null
+  });
+  const [deleteState, setDeleteState] = useState2({
+    loading: false,
+    error: null,
+    data: null
+  });
+  const createProject = useCallback2(async (input) => {
+    setCreateState({ loading: true, error: null, data: null });
+    try {
+      const result = await saas.createProject(input, {
+        projectId,
+        organizationId: "demo-org"
+      });
+      setCreateState({ loading: false, error: null, data: result });
+      options.onSuccess?.();
+      return result;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error("Failed to create project");
+      setCreateState({ loading: false, error, data: null });
+      options.onError?.(error);
+      return null;
+    }
+  }, [saas, projectId, options]);
+  const updateProject = useCallback2(async (input) => {
+    setUpdateState({ loading: true, error: null, data: null });
+    try {
+      const result = await saas.updateProject(input);
+      setUpdateState({ loading: false, error: null, data: result });
+      options.onSuccess?.();
+      return result;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error("Failed to update project");
+      setUpdateState({ loading: false, error, data: null });
+      options.onError?.(error);
+      return null;
+    }
+  }, [saas, options]);
+  const deleteProject = useCallback2(async (id) => {
+    setDeleteState({ loading: true, error: null, data: null });
+    try {
+      await saas.deleteProject(id);
+      setDeleteState({
+        loading: false,
+        error: null,
+        data: { success: true }
+      });
+      options.onSuccess?.();
+      return true;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error("Failed to delete project");
+      setDeleteState({ loading: false, error, data: null });
+      options.onError?.(error);
+      return false;
+    }
+  }, [saas, options]);
+  const archiveProject = useCallback2(async (id) => {
+    return updateProject({ id, status: "ARCHIVED" });
+  }, [updateProject]);
+  const activateProject = useCallback2(async (id) => {
+    return updateProject({ id, status: "ACTIVE" });
+  }, [updateProject]);
+  return {
+    createProject,
+    updateProject,
+    deleteProject,
+    archiveProject,
+    activateProject,
+    createState,
+    updateState,
+    deleteState,
+    isLoading: createState.loading || updateState.loading || deleteState.loading
+  };
+}
+
+// src/ui/hooks/index.ts
+"use client";
+export {
+  useProjectMutations,
+  useProjectList
+};

package/dist/browser/ui/hooks/useProjectList.js

@@ -0,0 +1,66 @@
+// src/ui/hooks/useProjectList.ts
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+function useProjectList(options = {}) {
+  const { handlers, projectId } = useTemplateRuntime();
+  const { saas } = handlers;
+  const [data, setData] = useState(null);
+  const [subscription, setSubscription] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const [page, setPage] = useState(1);
+  const fetchData = useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const [projectsResult, subscriptionResult] = await Promise.all([
+        saas.listProjects({
+          projectId,
+          status: options.status === "all" ? undefined : options.status,
+          search: options.search,
+          limit: options.limit ?? 20,
+          offset: (page - 1) * (options.limit ?? 20)
+        }),
+        saas.getSubscription({ projectId })
+      ]);
+      setData({
+        items: projectsResult.items,
+        total: projectsResult.total
+      });
+      setSubscription(subscriptionResult);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Unknown error"));
+    } finally {
+      setLoading(false);
+    }
+  }, [saas, projectId, options.status, options.search, options.limit, page]);
+  useEffect(() => {
+    fetchData();
+  }, [fetchData]);
+  const stats = useMemo(() => {
+    if (!data)
+      return null;
+    const items = data.items;
+    return {
+      total: data.total,
+      activeCount: items.filter((p) => p.status === "ACTIVE").length,
+      draftCount: items.filter((p) => p.status === "DRAFT").length,
+      projectLimit: 10,
+      usagePercent: Math.min(data.total / 10 * 100, 100)
+    };
+  }, [data]);
+  return {
+    data,
+    subscription,
+    loading,
+    error,
+    stats,
+    page,
+    refetch: fetchData,
+    nextPage: () => setPage((p) => p + 1),
+    prevPage: () => page > 1 && setPage((p) => p - 1)
+  };
+}
+export {
+  useProjectList
+};

package/dist/browser/ui/hooks/useProjectMutations.js

@@ -0,0 +1,91 @@
+// src/ui/hooks/useProjectMutations.ts
+import { useCallback, useState } from "react";
+import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+function useProjectMutations(options = {}) {
+  const { handlers, projectId } = useTemplateRuntime();
+  const { saas } = handlers;
+  const [createState, setCreateState] = useState({
+    loading: false,
+    error: null,
+    data: null
+  });
+  const [updateState, setUpdateState] = useState({
+    loading: false,
+    error: null,
+    data: null
+  });
+  const [deleteState, setDeleteState] = useState({
+    loading: false,
+    error: null,
+    data: null
+  });
+  const createProject = useCallback(async (input) => {
+    setCreateState({ loading: true, error: null, data: null });
+    try {
+      const result = await saas.createProject(input, {
+        projectId,
+        organizationId: "demo-org"
+      });
+      setCreateState({ loading: false, error: null, data: result });
+      options.onSuccess?.();
+      return result;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error("Failed to create project");
+      setCreateState({ loading: false, error, data: null });
+      options.onError?.(error);
+      return null;
+    }
+  }, [saas, projectId, options]);
+  const updateProject = useCallback(async (input) => {
+    setUpdateState({ loading: true, error: null, data: null });
+    try {
+      const result = await saas.updateProject(input);
+      setUpdateState({ loading: false, error: null, data: result });
+      options.onSuccess?.();
+      return result;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error("Failed to update project");
+      setUpdateState({ loading: false, error, data: null });
+      options.onError?.(error);
+      return null;
+    }
+  }, [saas, options]);
+  const deleteProject = useCallback(async (id) => {
+    setDeleteState({ loading: true, error: null, data: null });
+    try {
+      await saas.deleteProject(id);
+      setDeleteState({
+        loading: false,
+        error: null,
+        data: { success: true }
+      });
+      options.onSuccess?.();
+      return true;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error("Failed to delete project");
+      setDeleteState({ loading: false, error, data: null });
+      options.onError?.(error);
+      return false;
+    }
+  }, [saas, options]);
+  const archiveProject = useCallback(async (id) => {
+    return updateProject({ id, status: "ARCHIVED" });
+  }, [updateProject]);
+  const activateProject = useCallback(async (id) => {
+    return updateProject({ id, status: "ACTIVE" });
+  }, [updateProject]);
+  return {
+    createProject,
+    updateProject,
+    deleteProject,
+    archiveProject,
+    activateProject,
+    createState,
+    updateState,
+    deleteState,
+    isLoading: createState.loading || updateState.loading || deleteState.loading
+  };
+}
+export {
+  useProjectMutations
+};