@checkstack/infrastructure-common 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,32 @@
+# @checkstack/infrastructure-common
+
+## 0.2.0
+
+### Minor Changes
+
+- 8d1ef12: ## Infrastructure Configuration Shell & Cache System
+
+  ### New Packages
+
+  - **`@checkstack/cache-api`**: Core cache abstractions — `CacheProvider` interface, `createScopedCache` factory for plugin key isolation, `CachePlugin`/`CacheManager` lifecycle interfaces.
+  - **`@checkstack/cache-common`**: Shared cache types, RPC contract (`getPlugins`, `getConfiguration`, `updateConfiguration`), access rules, and plugin metadata.
+  - **`@checkstack/cache-backend`**: Cache settings RPC router — exposes plugin discovery, configuration read/write endpoints with access-gated authorization.
+  - **`@checkstack/cache-frontend`**: Cache configuration tab component for the Infrastructure Settings page.
+  - **`@checkstack/infrastructure-common`**: Infrastructure tab registry, routes, and shared types for the IDE-style configuration shell.
+  - **`@checkstack/infrastructure-frontend`**: Infrastructure Settings page with vertical tab bar, per-tab access control, and user menu integration.
+
+  ### Modified Packages
+
+  - **`@checkstack/backend-api`**: Added `cachePluginRegistry` and `cacheManager` to `RpcContext` and `coreServices`.
+  - **`@checkstack/backend`**: Registered cache services in boot sequence, added cache config loading, extended dependency sorter for cache plugin ordering.
+  - **`@checkstack/queue-frontend`**: Refactored from standalone `/queue/config` route to an infrastructure tab. Queue settings now live inside the Infrastructure Settings page.
+
+  ### Architecture
+
+  The former monolithic Queue Config page is replaced by a pluggable Infrastructure Settings shell (`/infrastructure/config`). Plugins register configuration tabs via `registerInfrastructureTab()` with their own access rules, icons, and components. The shell evaluates per-tab access and only renders tabs the user can see.
+
+### Patch Changes
+
+- Updated dependencies [8d1ef12]
+  - @checkstack/common@0.7.0
+  - @checkstack/frontend-api@0.3.11

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@checkstack/infrastructure-common",
+  "version": "0.2.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./src/index.ts"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "bun run lint:code",
+    "lint:code": "eslint . --max-warnings 0"
+  },
+  "dependencies": {
+    "@checkstack/common": "0.6.5",
+    "@checkstack/frontend-api": "0.3.10"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2",
+    "@checkstack/tsconfig": "0.0.5",
+    "@checkstack/scripts": "0.1.2",
+    "@types/react": "^18.3.18",
+    "react": "^18.3.1"
+  },
+  "checkstack": {
+    "type": "common"
+  }
+}

package/src/index.ts

@@ -0,0 +1,7 @@
+export { pluginMetadata } from "./plugin-metadata";
+export { infrastructureRoutes } from "./routes";
+export {
+  registerInfrastructureTab,
+  getInfrastructureTabs,
+  type InfrastructureTab,
+} from "./tabs";

package/src/plugin-metadata.ts

@@ -0,0 +1,9 @@
+import { definePluginMetadata } from "@checkstack/common";
+
+/**
+ * Plugin metadata for the infrastructure plugin.
+ * This is the single source of truth for the plugin ID.
+ */
+export const pluginMetadata = definePluginMetadata({
+  pluginId: "infrastructure",
+});

package/src/routes.ts

@@ -0,0 +1,8 @@
+import { createRoutes } from "@checkstack/common";
+
+/**
+ * Route definitions for the infrastructure plugin.
+ */
+export const infrastructureRoutes = createRoutes("infrastructure", {
+  config: "/config",
+});

package/src/tabs.ts

@@ -0,0 +1,62 @@
+import type React from "react";
+import type { AccessRule } from "@checkstack/common";
+
+/**
+ * Tab registration for the Infrastructure Configuration page.
+ *
+ * Each infrastructure concern (Queue, Cache, etc.) registers a tab
+ * with its own access rules, icon, and component.
+ *
+ * The shell page evaluates user access per tab and only shows
+ * tabs the user can read. If no tabs are visible, it shows "not authorized".
+ */
+export interface InfrastructureTab {
+  /** Unique tab ID (e.g., "queue", "cache") */
+  id: string;
+
+  /** Plugin ID that registers this tab (e.g., "queue", "cache") */
+  pluginId: string;
+
+  /** Tab display label */
+  label: string;
+
+  /** Tab icon component */
+  icon: React.ComponentType<{ className?: string }>;
+
+  /** The tab content component */
+  component: React.ComponentType<{ canUpdate: boolean }>;
+
+  /** Access rule required to view this tab */
+  readAccess: AccessRule;
+
+  /** Access rule required to modify settings in this tab */
+  manageAccess: AccessRule;
+
+  /** Sort order — lower numbers appear first */
+  order?: number;
+}
+
+/**
+ * Global tab registry for Infrastructure Configuration.
+ *
+ * Plugins register their tabs here during frontend plugin initialization.
+ * The infrastructure page reads from this registry to build its tab bar.
+ *
+ * This is a simple module-level registry — no React context needed
+ * since tabs are registered at module load time (during eager plugin loading).
+ */
+const tabs: InfrastructureTab[] = [];
+
+export function registerInfrastructureTab(tab: InfrastructureTab): void {
+  // Prevent duplicate registration
+  if (tabs.some((t) => t.id === tab.id)) {
+    return;
+  }
+  tabs.push(tab);
+  // Keep sorted by order
+  tabs.sort((a, b) => (a.order ?? 100) - (b.order ?? 100));
+}
+
+export function getInfrastructureTabs(): readonly InfrastructureTab[] {
+  return tabs;
+}

package/tsconfig.json

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