@checkstack/cache-backend 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,36 @@
+# @checkstack/cache-backend
+
+## 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]
+- Updated dependencies [8d1ef12]
+- Updated dependencies [8d1ef12]
+  - @checkstack/common@0.7.0
+  - @checkstack/cache-api@0.2.0
+  - @checkstack/cache-common@0.2.0
+  - @checkstack/backend-api@0.13.0

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@checkstack/cache-backend",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "src/index.ts",
+  "checkstack": {
+    "type": "backend"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "bun run lint:code",
+    "lint:code": "eslint . --max-warnings 0"
+  },
+  "dependencies": {
+    "@checkstack/backend-api": "0.12.0",
+    "@checkstack/cache-api": "0.1.0",
+    "@checkstack/cache-common": "0.1.0",
+    "@checkstack/common": "0.6.5",
+    "@orpc/server": "^1.13.2",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@checkstack/scripts": "0.1.2",
+    "@checkstack/tsconfig": "0.0.5",
+    "typescript": "^5.7.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,28 @@
+import { createBackendPlugin, coreServices } from "@checkstack/backend-api";
+import {
+  cacheAccessRules,
+  pluginMetadata,
+  cacheContract,
+} from "@checkstack/cache-common";
+import { createCacheRouter } from "./router";
+
+export default createBackendPlugin({
+  metadata: pluginMetadata,
+  register(env) {
+    env.registerAccessRules(cacheAccessRules);
+
+    env.registerInit({
+      deps: {
+        logger: coreServices.logger,
+        rpc: coreServices.rpc,
+        config: coreServices.config,
+      },
+      init: async ({ logger, rpc, config }) => {
+        logger.debug("📦 Initializing Cache Settings Backend...");
+
+        const cacheRouter = createCacheRouter(config);
+        rpc.registerRouter(cacheRouter, cacheContract);
+      },
+    });
+  },
+});

package/src/router.ts

@@ -0,0 +1,69 @@
+import {
+  toJsonSchema,
+  ConfigService,
+  RpcContext,
+  autoAuthMiddleware,
+} from "@checkstack/backend-api";
+import { cacheContract } from "@checkstack/cache-common";
+import { implement, ORPCError } from "@orpc/server";
+import { extractErrorMessage } from "@checkstack/common";
+
+const os = implement(cacheContract)
+  .$context<RpcContext>()
+  .use(autoAuthMiddleware);
+
+export const createCacheRouter = (configService: ConfigService) => {
+  return os.router({
+    getPlugins: os.getPlugins.handler(async ({ context }) => {
+      const plugins = context.cachePluginRegistry.getPlugins().map((p) => ({
+        id: p.id,
+        displayName: p.displayName,
+        description: p.description,
+        configVersion: p.configVersion,
+        configSchema: toJsonSchema(p.configSchema),
+      }));
+      return plugins;
+    }),
+
+    getConfiguration: os.getConfiguration.handler(async ({ context }) => {
+      const activePluginId = context.cacheManager.getActivePlugin();
+      const plugin = context.cachePluginRegistry.getPlugin(activePluginId);
+
+      if (!plugin) {
+        throw new Error("Active cache plugin not found");
+      }
+
+      // Get redacted config from ConfigService using plugin's schema
+      const config = await configService.getRedacted(
+        activePluginId,
+        plugin.configSchema,
+        plugin.configVersion,
+      );
+
+      return {
+        pluginId: activePluginId,
+        config: config || {},
+      };
+    }),
+
+    updateConfiguration: os.updateConfiguration.handler(
+      async ({ input, context }) => {
+        const { pluginId, config } = input;
+        try {
+          await context.cacheManager.setActiveBackend(pluginId, config);
+        } catch (error) {
+          throw new ORPCError("INTERNAL_SERVER_ERROR", {
+            message: extractErrorMessage(error),
+          });
+        }
+        context.logger.info(
+          `Cache configuration updated to plugin: ${pluginId}`,
+        );
+        return {
+          pluginId,
+          config,
+        };
+      },
+    ),
+  });
+};

package/tsconfig.json

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