@checkstack/backend 0.4.9 → 0.4.11

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # @checkstack/backend
 
+## 0.4.11
+
+### Patch Changes
+
+- 48c2080: Migrate aggregation from batch to incremental (`mergeResult`)
+
+  ### Breaking Changes (Internal)
+
+  - Replaced `aggregateResult(runs[])` with `mergeResult(existing, run)` interface across all HealthCheckStrategy and CollectorStrategy implementations
+
+  ### New Features
+
+  - Added incremental aggregation utilities in `@checkstack/backend-api`:
+    - `mergeCounter()` - track occurrences
+    - `mergeAverage()` - track sum/count, compute avg
+    - `mergeRate()` - track success/total, compute %
+    - `mergeMinMax()` - track min/max values
+  - Exported Zod schemas for internal state: `averageStateSchema`, `rateStateSchema`, `minMaxStateSchema`, `counterStateSchema`
+
+  ### Improvements
+
+  - Enables O(1) storage overhead by maintaining incremental aggregation state
+  - Prepares for real-time hourly aggregation without batch accumulation
+
+- Updated dependencies [f676e11]
+- Updated dependencies [48c2080]
+  - @checkstack/common@0.6.2
+  - @checkstack/backend-api@0.6.0
+  - @checkstack/api-docs-common@0.1.6
+  - @checkstack/auth-common@0.5.5
+  - @checkstack/signal-backend@0.1.9
+  - @checkstack/signal-common@0.1.6
+  - @checkstack/queue-api@0.2.3
+
+## 0.4.10
+
+### Patch Changes
+
+- f8ce585: Improved RPC error logging to include full stack traces for procedure errors. Previously, errors inside RPC handlers (such as database table not found errors) resulted in silent 500 responses. Now these errors are logged with detailed information to the backend console for easier debugging.
+
 ## 0.4.9
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/backend",
-  "version": "0.4.9",
+  "version": "0.4.11",
   "type": "module",
   "scripts": {
     "dev": "bun --env-file=../../.env --watch src/index.ts",
@@ -10,14 +10,14 @@
     "lint:code": "eslint . --max-warnings 0"
   },
   "dependencies": {
-    "@checkstack/api-docs-common": "0.1.4",
-    "@checkstack/auth-common": "0.5.3",
-    "@checkstack/backend-api": "0.5.1",
-    "@checkstack/common": "0.6.0",
-    "@checkstack/drizzle-helper": "0.0.2",
-    "@checkstack/queue-api": "0.2.1",
-    "@checkstack/signal-backend": "0.1.7",
-    "@checkstack/signal-common": "0.1.4",
+    "@checkstack/api-docs-common": "0.1.5",
+    "@checkstack/auth-common": "0.5.4",
+    "@checkstack/backend-api": "0.5.2",
+    "@checkstack/common": "0.6.1",
+    "@checkstack/drizzle-helper": "0.0.3",
+    "@checkstack/queue-api": "0.2.2",
+    "@checkstack/signal-backend": "0.1.8",
+    "@checkstack/signal-common": "0.1.5",
     "@hono/zod-validator": "^0.7.6",
     "@orpc/client": "^1.13.2",
     "@orpc/openapi": "^1.13.2",
@@ -35,8 +35,8 @@
     "drizzle-kit": "^0.31.8",
     "@types/pg": "^8.11.0",
     "@types/bun": "latest",
-    "@checkstack/tsconfig": "0.0.2",
-    "@checkstack/scripts": "0.1.0",
-    "@checkstack/test-utils-backend": "0.1.7"
+    "@checkstack/tsconfig": "0.0.3",
+    "@checkstack/scripts": "0.1.1",
+    "@checkstack/test-utils-backend": "0.1.8"
   }
 }

package/src/health-check-plugin-integration.test.ts

@@ -55,7 +55,7 @@ describe("HealthCheck Plugin Integration", () => {
         schema: z.record(z.string(), z.unknown()),
       }),
       createClient: mockCreateClient,
-      aggregateResult: mock(() => ({})),
+      mergeResult: mock(() => ({})),
     };
 
     // 2. Define a mock plugin that registers this strategy

package/src/plugin-manager/api-router.ts

@@ -56,21 +56,42 @@ export function createApiRouteHandler({
       rootRpcRouter[pluginId] = router;
     }
 
+    // Resolve logger first for use in interceptor
+    const logger = await getService(coreServices.logger);
+
     const rpcHandler = new RPCHandler(
-      rootRpcRouter as ConstructorParameters<typeof RPCHandler>[0]
+      rootRpcRouter as ConstructorParameters<typeof RPCHandler>[0],
+      {
+        interceptors: [
+          async ({ next, ...rest }) => {
+            try {
+              return await next(rest);
+            } catch (error) {
+              if (logger) {
+                (logger as Logger).error(
+                  `RPC procedure error: ${String(error)}`,
+                );
+                if (error instanceof Error && error.stack) {
+                  (logger as Logger).error(`Stack trace: ${error.stack}`);
+                }
+              }
+              throw error;
+            }
+          },
+        ],
+      },
     );
 
     // Resolve core services for RPC context
     const auth = await getService(coreServices.auth);
-    const logger = await getService(coreServices.logger);
     const db = await getService(coreServices.database);
     const fetch = await getService(coreServices.fetch);
     const healthCheckRegistry = await getService(
-      coreServices.healthCheckRegistry
+      coreServices.healthCheckRegistry,
     );
     const collectorRegistry = await getService(coreServices.collectorRegistry);
     const queuePluginRegistry = await getService(
-      coreServices.queuePluginRegistry
+      coreServices.queuePluginRegistry,
     );
     const queueManager = await getService(coreServices.queueManager);
     const eventBus = await getService(coreServices.eventBus);
@@ -119,29 +140,24 @@ export function createApiRouteHandler({
     };
 
     // 1. Try oRPC first
-    try {
-      const { matched, response } = await rpcHandler.handle(c.req.raw, {
-        prefix: "/api",
-        context,
-      });
-
-      if (matched) {
-        return c.newResponse(response.body, response);
-      }
+    const { matched, response } = await rpcHandler.handle(c.req.raw, {
+      prefix: "/api",
+      context,
+    });
 
-      logger.debug(`RPC mismatch for: ${c.req.method} ${pathname}`);
-    } catch (error) {
-      logger.error(`RPC Handler error: ${String(error)}`);
+    if (matched) {
+      return c.newResponse(response.body, response);
     }
 
+    logger.debug(`RPC mismatch for: ${c.req.method} ${pathname}`);
+
     // 2. Try native handlers
     // Sort by path length (descending) to ensure more specific paths are tried first
-    const sortedHandlers = [...pluginHttpHandlers.entries()].toSorted(function (
-      a,
-      b
-    ) {
-      return b[0].length - a[0].length;
-    });
+    const sortedHandlers = [...pluginHttpHandlers.entries()].toSorted(
+      function (a, b) {
+        return b[0].length - a[0].length;
+      },
+    );
 
     for (const [path, handler] of sortedHandlers) {
       if (pathname.startsWith(path)) {
@@ -158,7 +174,7 @@ export function createApiRouteHandler({
  */
 export function registerApiRoute(
   rootRouter: Hono,
-  handler: ReturnType<typeof createApiRouteHandler>
+  handler: ReturnType<typeof createApiRouteHandler>,
 ) {
   rootRouter.all("/api/:pluginId/*", handler);
 }

package/src/services/health-check-registry.test.ts

@@ -36,9 +36,9 @@ describe("CoreHealthCheckRegistry", () => {
       schema: z.record(z.string(), z.unknown()),
     }),
     createClient: mock(() =>
-      Promise.resolve({ client: { exec: async () => ({}) }, close: () => {} })
+      Promise.resolve({ client: { exec: async () => ({}) }, close: () => {} }),
     ),
-    aggregateResult: mock(() => ({})),
+    mergeResult: mock(() => ({})),
   };
 
   const mockStrategy2: HealthCheckStrategy = {
@@ -58,9 +58,9 @@ describe("CoreHealthCheckRegistry", () => {
       schema: z.record(z.string(), z.unknown()),
     }),
     createClient: mock(() =>
-      Promise.resolve({ client: { exec: async () => ({}) }, close: () => {} })
+      Promise.resolve({ client: { exec: async () => ({}) }, close: () => {} }),
     ),
-    aggregateResult: mock(() => ({})),
+    mergeResult: mock(() => ({})),
   };
 
   beforeEach(() => {