@checkstack/queue-backend 0.0.2

package/CHANGELOG.md

@@ -0,0 +1,40 @@
+# @checkstack/queue-backend
+
+## 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/backend-api@0.0.2
+  - @checkstack/common@0.0.2
+  - @checkstack/queue-api@0.0.2
+  - @checkstack/queue-common@0.0.2
+
+## 0.0.3
+
+### Patch Changes
+
+- Updated dependencies [b4eb432]
+- Updated dependencies [a65e002]
+  - @checkstack/backend-api@1.1.0
+  - @checkstack/common@0.2.0
+  - @checkstack/queue-api@1.0.1
+  - @checkstack/queue-common@0.0.3
+
+## 0.0.2
+
+### Patch Changes
+
+- Updated dependencies [ffc28f6]
+- Updated dependencies [e4d83fc]
+- Updated dependencies [71275dd]
+- Updated dependencies [ae19ff6]
+- Updated dependencies [b55fae6]
+- Updated dependencies [b354ab3]
+- Updated dependencies [8e889b4]
+- Updated dependencies [81f3f85]
+  - @checkstack/common@0.1.0
+  - @checkstack/backend-api@1.0.0
+  - @checkstack/queue-api@1.0.0
+  - @checkstack/queue-common@0.0.2

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@checkstack/queue-backend",
+  "version": "0.0.2",
+  "type": "module",
+  "main": "src/index.ts",
+  "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/backend-api": "workspace:*",
+    "@checkstack/queue-api": "workspace:*",
+    "@checkstack/queue-common": "workspace:*",
+    "@hono/zod-validator": "^0.4.1",
+    "hono": "^4.6.14",
+    "zod": "^4.0.0",
+    "@checkstack/common": "workspace:*"
+  },
+  "devDependencies": {
+    "@checkstack/scripts": "workspace:*",
+    "@checkstack/tsconfig": "workspace:*",
+    "@orpc/server": "^1.13.2",
+    "typescript": "^5.7.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,32 @@
+import {
+  createBackendPlugin,
+  coreServices,
+} from "@checkstack/backend-api";
+import {
+  permissionList,
+  pluginMetadata,
+  queueContract,
+} from "@checkstack/queue-common";
+import { createQueueRouter } from "./router";
+
+export default createBackendPlugin({
+  metadata: pluginMetadata,
+  register(env) {
+    env.registerPermissions(permissionList);
+
+    env.registerInit({
+      deps: {
+        logger: coreServices.logger,
+        rpc: coreServices.rpc,
+        config: coreServices.config,
+      },
+      init: async ({ logger, rpc, config }) => {
+        logger.debug("📋 Initializing Queue Settings Backend...");
+
+        // 4. Register oRPC router
+        const queueRouter = createQueueRouter(config);
+        rpc.registerRouter(queueRouter, queueContract);
+      },
+    });
+  },
+});

package/src/router.test.ts

@@ -0,0 +1,84 @@
+import { describe, it, expect, mock } from "bun:test";
+import { createQueueRouter } from "./router";
+import { createMockRpcContext } from "@checkstack/backend-api";
+import { call } from "@orpc/server";
+import { z } from "zod";
+
+describe("Queue Router", () => {
+  const mockUser = {
+    id: "test-user",
+    permissions: ["*"],
+    roles: ["admin"],
+  } as any;
+
+  const mockPlugins = [
+    {
+      id: "memory",
+      displayName: "In-Memory Queue",
+      description: "Simple in-memory queue for testing",
+      configVersion: 1,
+      configSchema: z.object({}),
+    },
+  ];
+
+  const mockRegistry: any = {
+    getPlugins: mock(() => mockPlugins),
+    getPlugin: mock((id: string) => mockPlugins.find((p) => p.id === id)),
+  };
+
+  const mockManager: any = {
+    getActivePlugin: mock(() => "memory"),
+    setActiveBackend: mock(() =>
+      Promise.resolve({ success: true, migratedRecurringJobs: 0, warnings: [] })
+    ),
+  };
+
+  const mockConfigService: any = {
+    getRedacted: mock(() => Promise.resolve({ concurrency: 10 })),
+  };
+
+  const router = createQueueRouter(mockConfigService);
+
+  it("getPlugins returns list of plugins", async () => {
+    const context = createMockRpcContext({
+      user: mockUser,
+      queuePluginRegistry: mockRegistry,
+    });
+
+    const result = await call(router.getPlugins, undefined, { context });
+    expect(result).toHaveLength(1);
+    expect(result[0].id).toBe("memory");
+  });
+
+  it("getConfiguration returns redacted config", async () => {
+    const context = createMockRpcContext({
+      user: mockUser,
+      queuePluginRegistry: mockRegistry,
+      queueManager: mockManager,
+    });
+
+    const result = await call(router.getConfiguration, undefined, { context });
+    expect(result.pluginId).toBe("memory");
+    expect(result.config).toEqual({ concurrency: 10 });
+    expect(mockConfigService.getRedacted).toHaveBeenCalledWith(
+      "memory",
+      mockPlugins[0].configSchema,
+      mockPlugins[0].configVersion
+    );
+  });
+
+  it("updateConfiguration updates active plugin", async () => {
+    const context = createMockRpcContext({
+      user: mockUser,
+      queueManager: mockManager,
+    });
+
+    const result = await call(
+      router.updateConfiguration,
+      { pluginId: "memory", config: {} },
+      { context }
+    );
+    expect(result.pluginId).toBe("memory");
+    expect(mockManager.setActiveBackend).toHaveBeenCalled();
+  });
+});

package/src/router.ts

@@ -0,0 +1,71 @@
+import {
+  toJsonSchema,
+  ConfigService,
+  RpcContext,
+  autoAuthMiddleware,
+} from "@checkstack/backend-api";
+import { queueContract } from "@checkstack/queue-common";
+import { implement, ORPCError } from "@orpc/server";
+
+const os = implement(queueContract)
+  .$context<RpcContext>()
+  .use(autoAuthMiddleware);
+
+export const createQueueRouter = (configService: ConfigService) => {
+  return os.router({
+    getPlugins: os.getPlugins.handler(async ({ context }) => {
+      const plugins = context.queuePluginRegistry.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.queueManager.getActivePlugin();
+      const plugin = context.queuePluginRegistry.getPlugin(activePluginId);
+
+      if (!plugin) {
+        throw new Error("Active queue 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.queueManager.setActiveBackend(pluginId, config);
+        } catch (error) {
+          if (error instanceof Error) {
+            throw new ORPCError("INTERNAL_SERVER_ERROR", {
+              message: error.message,
+            });
+          }
+          throw error;
+        }
+        context.logger.info(
+          `Queue configuration updated to plugin: ${pluginId}`
+        );
+        return {
+          pluginId,
+          config,
+        };
+      }
+    ),
+  });
+};

package/tsconfig.json

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