@checkstack/queue-frontend 0.0.2

package/CHANGELOG.md

@@ -0,0 +1,60 @@
+# @checkstack/queue-frontend
+
+## 0.0.2
+
+### Patch Changes
+
+- d20d274: Initial release of all @checkstack packages. Rebranded from Checkmate to Checkstack with new npm organization @checkstack and domain checkstack.dev.
+- Updated dependencies [d20d274]
+  - @checkstack/common@0.0.2
+  - @checkstack/frontend-api@0.0.2
+  - @checkstack/queue-common@0.0.2
+  - @checkstack/ui@0.0.2
+
+## 0.0.4
+
+### Patch Changes
+
+- 32ea706: ### User Menu Loading State Fix
+
+  Fixed user menu items "popping in" one after another due to independent async permission checks.
+
+  **Changes:**
+
+  - Added `UserMenuItemsContext` interface with `permissions` and `hasCredentialAccount` to `@checkstack/frontend-api`
+  - `LoginNavbarAction` now pre-fetches all permissions and credential account info before rendering the menu
+  - All user menu item components now use the passed context for synchronous permission checks instead of async hooks
+  - Uses `qualifyPermissionId` helper for fully-qualified permission IDs
+
+  **Result:** All menu items appear simultaneously when the user menu opens.
+
+- Updated dependencies [52231ef]
+- Updated dependencies [b0124ef]
+- Updated dependencies [54cc787]
+- Updated dependencies [a65e002]
+- Updated dependencies [ae33df2]
+- Updated dependencies [32ea706]
+  - @checkstack/ui@0.1.2
+  - @checkstack/common@0.2.0
+  - @checkstack/frontend-api@0.1.0
+  - @checkstack/queue-common@0.0.3
+
+## 0.0.3
+
+### Patch Changes
+
+- Updated dependencies [0f8cc7d]
+  - @checkstack/frontend-api@0.0.3
+  - @checkstack/ui@0.1.1
+
+## 0.0.2
+
+### Patch Changes
+
+- Updated dependencies [eff5b4e]
+- Updated dependencies [ffc28f6]
+- Updated dependencies [b354ab3]
+  - @checkstack/ui@0.1.0
+  - @checkstack/common@0.1.0
+  - @checkstack/frontend-api@0.0.2
+  - @checkstack/queue-common@0.0.2

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@checkstack/queue-frontend",
+  "version": "0.0.2",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "bun run lint:code",
+    "lint:code": "eslint . --max-warnings 0"
+  },
+  "dependencies": {
+    "@checkstack/common": "workspace:*",
+    "@checkstack/frontend-api": "workspace:*",
+    "@checkstack/queue-common": "workspace:*",
+    "@checkstack/ui": "workspace:*",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "lucide-react": "^0.468.0",
+    "prismjs": "^1.29.0",
+    "react": "^18.3.1",
+    "react-router-dom": "^7.1.1",
+    "react-simple-code-editor": "^0.14.1",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.18",
+    "typescript": "^5.7.2",
+    "@checkstack/tsconfig": "workspace:*",
+    "@checkstack/scripts": "workspace:*"
+  }
+}

package/src/api.ts

@@ -0,0 +1,15 @@
+import { createApiRef } from "@checkstack/frontend-api";
+import { QueueApi } from "@checkstack/queue-common";
+import type { InferClient } from "@checkstack/common";
+
+// Re-export types for convenience
+export type {
+  QueuePluginDto,
+  QueueConfigurationDto,
+  UpdateQueueConfiguration,
+} from "@checkstack/queue-common";
+
+// QueueApiClient type inferred from the client definition
+export type QueueApiClient = InferClient<typeof QueueApi>;
+
+export const queueApiRef = createApiRef<QueueApiClient>("queue-api");

package/src/components/UserMenuItems.tsx

@@ -0,0 +1,33 @@
+import React from "react";
+import { Link } from "react-router-dom";
+import { ListOrdered } from "lucide-react";
+import type { UserMenuItemsContext } from "@checkstack/frontend-api";
+import { DropdownMenuItem } from "@checkstack/ui";
+import { qualifyPermissionId, resolveRoute } from "@checkstack/common";
+import {
+  queueRoutes,
+  permissions,
+  pluginMetadata,
+} from "@checkstack/queue-common";
+
+export const QueueUserMenuItems = ({
+  permissions: userPerms,
+}: UserMenuItemsContext) => {
+  const qualifiedId = qualifyPermissionId(
+    pluginMetadata,
+    permissions.queueRead
+  );
+  const canRead = userPerms.includes("*") || userPerms.includes(qualifiedId);
+
+  if (!canRead) {
+    return <React.Fragment />;
+  }
+
+  return (
+    <Link to={resolveRoute(queueRoutes.routes.config)}>
+      <DropdownMenuItem icon={<ListOrdered className="h-4 w-4" />}>
+        Queue Settings
+      </DropdownMenuItem>
+    </Link>
+  );
+};

package/src/index.tsx

@@ -0,0 +1,44 @@
+import {
+  rpcApiRef,
+  ApiRef,
+  UserMenuItemsSlot,
+  createSlotExtension,
+  createFrontendPlugin,
+} from "@checkstack/frontend-api";
+import { queueApiRef, type QueueApiClient } from "./api";
+import { QueueConfigPage } from "./pages/QueueConfigPage";
+import { QueueUserMenuItems } from "./components/UserMenuItems";
+import {
+  queueRoutes,
+  QueueApi,
+  pluginMetadata,
+  permissions,
+} from "@checkstack/queue-common";
+
+export const queuePlugin = createFrontendPlugin({
+  metadata: pluginMetadata,
+  apis: [
+    {
+      ref: queueApiRef,
+      factory: (deps: { get: <T>(ref: ApiRef<T>) => T }): QueueApiClient => {
+        const rpcApi = deps.get(rpcApiRef);
+        return rpcApi.forPlugin(QueueApi);
+      },
+    },
+  ],
+  routes: [
+    {
+      route: queueRoutes.routes.config,
+      element: <QueueConfigPage />,
+      permission: permissions.queueRead,
+    },
+  ],
+  extensions: [
+    createSlotExtension(UserMenuItemsSlot, {
+      id: "queue.user-menu.items",
+      component: QueueUserMenuItems,
+    }),
+  ],
+});
+
+export * from "./api";

package/src/pages/QueueConfigPage.tsx

@@ -0,0 +1,126 @@
+import { useEffect, useState } from "react";
+import {
+  useApi,
+  wrapInSuspense,
+  permissionApiRef,
+} from "@checkstack/frontend-api";
+import { queueApiRef } from "../api";
+import { QueuePluginDto } from "@checkstack/queue-common";
+import {
+  Button,
+  Alert,
+  AlertTitle,
+  AlertDescription,
+  PageLayout,
+  PluginConfigForm,
+  Card,
+  CardContent,
+  CardFooter,
+  CardHeader,
+  CardTitle,
+  useToast,
+} from "@checkstack/ui";
+import { AlertTriangle, Save } from "lucide-react";
+
+const QueueConfigPageContent = () => {
+  const api = useApi(queueApiRef);
+  const permissionApi = useApi(permissionApiRef);
+  const toast = useToast();
+  const { allowed: canRead, loading: permissionLoading } =
+    permissionApi.useResourcePermission("queue", "read");
+  const { allowed: canUpdate } = permissionApi.useManagePermission("queue");
+
+  const [plugins, setPlugins] = useState<QueuePluginDto[]>([]);
+  const [selectedPluginId, setSelectedPluginId] = useState<string>("");
+  const [config, setConfig] = useState<Record<string, unknown>>({});
+  const [isSaving, setIsSaving] = useState(false);
+
+  useEffect(() => {
+    const fetchData = async () => {
+      const [pluginsList, configuration] = await Promise.all([
+        api.getPlugins(),
+        api.getConfiguration(),
+      ]);
+      setPlugins(pluginsList);
+      setSelectedPluginId(configuration.pluginId);
+      setConfig(configuration.config);
+    };
+    fetchData();
+  }, [api]);
+
+  const handleSave = async () => {
+    if (!selectedPluginId) return;
+    setIsSaving(true);
+    try {
+      await api.updateConfiguration({
+        pluginId: selectedPluginId,
+        config,
+      });
+      toast.success("Configuration saved successfully!");
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      toast.error(`Failed to save configuration: ${message}`);
+    } finally {
+      setIsSaving(false);
+    }
+  };
+
+  const isMemoryQueue = selectedPluginId === "memory";
+
+  return (
+    <PageLayout
+      title="Queue Settings"
+      subtitle="Configure the queue system for background jobs"
+      loading={permissionLoading}
+      allowed={canRead}
+      maxWidth="3xl"
+    >
+      <Card>
+        <CardHeader>
+          <CardTitle>Queue Configuration</CardTitle>
+          <p className="text-sm text-muted-foreground">
+            Select and configure the queue plugin
+          </p>
+        </CardHeader>
+        <CardContent className="space-y-6">
+          {isMemoryQueue && (
+            <Alert variant="warning">
+              <AlertTriangle className="h-5 w-5" />
+              <div>
+                <AlertTitle>In-Memory Queue Warning</AlertTitle>
+                <AlertDescription>
+                  The in-memory queue is suitable for development and
+                  single-instance deployments only. It will not scale across
+                  multiple instances and jobs will be lost on restart. For
+                  production environments with multiple instances, consider
+                  using a persistent queue implementation.
+                </AlertDescription>
+              </div>
+            </Alert>
+          )}
+
+          <PluginConfigForm
+            label="Queue Plugin"
+            plugins={plugins}
+            selectedPluginId={selectedPluginId}
+            onPluginChange={(value) => {
+              setSelectedPluginId(value);
+              setConfig({});
+            }}
+            config={config}
+            onConfigChange={setConfig}
+            disabled={!canUpdate}
+          />
+        </CardContent>
+        <CardFooter className="flex justify-end gap-2">
+          <Button onClick={handleSave} disabled={!canUpdate || isSaving}>
+            <Save className="mr-2 h-4 w-4" />
+            {isSaving ? "Saving..." : "Save Configuration"}
+          </Button>
+        </CardFooter>
+      </Card>
+    </PageLayout>
+  );
+};
+
+export const QueueConfigPage = wrapInSuspense(QueueConfigPageContent);

package/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "extends": "@checkstack/tsconfig/frontend.json",
+  "include": [
+    "src"
+  ]
+}