@powersync/service-core 0.8.6 → 0.8.8

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @powersync/service-core
 
+## 0.8.8
+
+### Patch Changes
+
+- 21de621: Add probe endpoints which can be used for system health checks.
+
+## 0.8.7
+
+### Patch Changes
+
+- 6b72e6c: Improved Postgres connection port restrictions. Connections are now supported on ports >= 1024.
+
 ## 0.8.6
 
 ### Patch Changes

package/dist/routes/configure-fastify.d.ts

@@ -566,6 +566,22 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
             }, import("./router.js").Context, import("./router.js").BasicRouterRequest>) => Promise<{
                 write_checkpoint: string;
             }>;
+        }) | (import("@powersync/lib-services-framework").Endpoint<unknown, import("@powersync/lib-services-framework").RouterResponse<{
+            ready: boolean;
+            started: boolean;
+            touched_at: Date;
+        }>, import("./router.js").Context, import("./router.js").RequestEndpointHandlerPayload<unknown, import("./router.js").Context, import("./router.js").BasicRouterRequest>, import("@powersync/lib-services-framework").EndpointHandler<import("./router.js").RequestEndpointHandlerPayload<unknown, import("./router.js").Context, import("./router.js").BasicRouterRequest>, import("@powersync/lib-services-framework").RouterResponse<{
+            ready: boolean;
+            started: boolean;
+            touched_at: Date;
+        }>>> & {
+            path: import("./endpoints/probes.js").ProbeRoutes;
+            method: import("@powersync/lib-services-framework").HTTPMethod.GET;
+            handler: () => Promise<import("@powersync/lib-services-framework").RouterResponse<{
+                ready: boolean;
+                started: boolean;
+                touched_at: Date;
+            }>>;
         }) | (import("@powersync/lib-services-framework").Endpoint<{
             content: string;
         }, {

package/dist/routes/configure-fastify.js

@@ -1,12 +1,13 @@
 import { registerFastifyRoutes } from './route-register.js';
 import { ADMIN_ROUTES } from './endpoints/admin.js';
 import { CHECKPOINT_ROUTES } from './endpoints/checkpointing.js';
+import { PROBES_ROUTES } from './endpoints/probes.js';
 import { SYNC_RULES_ROUTES } from './endpoints/sync-rules.js';
 import { SYNC_STREAM_ROUTES } from './endpoints/sync-stream.js';
 import { createRequestQueueHook } from './hooks.js';
 export const DEFAULT_ROUTE_OPTIONS = {
     api: {
-        routes: [...ADMIN_ROUTES, ...CHECKPOINT_ROUTES, ...SYNC_RULES_ROUTES],
+        routes: [...ADMIN_ROUTES, ...CHECKPOINT_ROUTES, ...SYNC_RULES_ROUTES, ...PROBES_ROUTES],
         queueOptions: {
             concurrency: 10,
             max_queue_depth: 20

package/dist/routes/configure-fastify.js.map

@@ -1 +1 @@
-{"version":3,"file":"configure-fastify.js","sourceRoot":"","sources":["../../src/routes/configure-fastify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAI5D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAA4B,MAAM,YAAY,CAAC;AA0B9E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE;QACH,MAAM,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,iBAAiB,EAAE,GAAG,iBAAiB,CAAC;QACrE,YAAY,EAAE;YACZ,WAAW,EAAE,EAAE;YACf,eAAe,EAAE,EAAE;SACpB;KACF;IACD,UAAU,EAAE;QACV,MAAM,EAAE,CAAC,GAAG,kBAAkB,CAAC;QAC/B,YAAY,EAAE;YACZ,WAAW,EAAE,GAAG;YAChB,eAAe,EAAE,CAAC;SACnB;KACF;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA+B,EAAE,OAA4B;IAClG,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,qBAAqB,EAAE,GAAG,OAAO,CAAC;IAC3D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW,YAAY;QAC1C,qBAAqB,CACnB,YAAY,EACZ,KAAK,IAAI,EAAE;YACT,OAAO;gBACL,OAAO,EAAE,SAAS;gBAClB,MAAM,EAAE,MAAM;aACf,CAAC;QACJ,CAAC,EACD,MAAM,CAAC,GAAG,EAAE,MAAM,IAAI,qBAAqB,CAAC,GAAG,CAAC,MAAM,CACvD,CAAC;QACF,uCAAuC;QACvC,YAAY,CAAC,OAAO,CAClB,WAAW,EACX,sBAAsB,CAAC,MAAM,CAAC,GAAG,EAAE,YAAY,IAAI,qBAAqB,CAAC,GAAG,CAAC,YAAY,CAAC,CAC3F,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,qDAAqD;IACrD,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW,YAAY;QAC1C,qBAAqB,CACnB,YAAY,EACZ,KAAK,IAAI,EAAE;YACT,OAAO;gBACL,OAAO,EAAE,SAAS;gBAClB,MAAM,EAAE,MAAM;aACf,CAAC;QACJ,CAAC,EACD,MAAM,CAAC,UAAU,EAAE,MAAM,IAAI,qBAAqB,CAAC,UAAU,CAAC,MAAM,CACrE,CAAC;QACF,uCAAuC;QACvC,YAAY,CAAC,OAAO,CAClB,WAAW,EACX,sBAAsB,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,IAAI,qBAAqB,CAAC,UAAU,CAAC,YAAY,CAAC,CACzG,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"configure-fastify.js","sourceRoot":"","sources":["../../src/routes/configure-fastify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAI5D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAA4B,MAAM,YAAY,CAAC;AA0B9E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE;QACH,MAAM,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,GAAG,aAAa,CAAC;QACvF,YAAY,EAAE;YACZ,WAAW,EAAE,EAAE;YACf,eAAe,EAAE,EAAE;SACpB;KACF;IACD,UAAU,EAAE;QACV,MAAM,EAAE,CAAC,GAAG,kBAAkB,CAAC;QAC/B,YAAY,EAAE;YACZ,WAAW,EAAE,GAAG;YAChB,eAAe,EAAE,CAAC;SACnB;KACF;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA+B,EAAE,OAA4B;IAClG,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,qBAAqB,EAAE,GAAG,OAAO,CAAC;IAC3D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW,YAAY;QAC1C,qBAAqB,CACnB,YAAY,EACZ,KAAK,IAAI,EAAE;YACT,OAAO;gBACL,OAAO,EAAE,SAAS;gBAClB,MAAM,EAAE,MAAM;aACf,CAAC;QACJ,CAAC,EACD,MAAM,CAAC,GAAG,EAAE,MAAM,IAAI,qBAAqB,CAAC,GAAG,CAAC,MAAM,CACvD,CAAC;QACF,uCAAuC;QACvC,YAAY,CAAC,OAAO,CAClB,WAAW,EACX,sBAAsB,CAAC,MAAM,CAAC,GAAG,EAAE,YAAY,IAAI,qBAAqB,CAAC,GAAG,CAAC,YAAY,CAAC,CAC3F,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,qDAAqD;IACrD,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW,YAAY;QAC1C,qBAAqB,CACnB,YAAY,EACZ,KAAK,IAAI,EAAE;YACT,OAAO;gBACL,OAAO,EAAE,SAAS;gBAClB,MAAM,EAAE,MAAM;aACf,CAAC;QACJ,CAAC,EACD,MAAM,CAAC,UAAU,EAAE,MAAM,IAAI,qBAAqB,CAAC,UAAU,CAAC,MAAM,CACrE,CAAC;QACF,uCAAuC;QACvC,YAAY,CAAC,OAAO,CAClB,WAAW,EACX,sBAAsB,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,IAAI,qBAAqB,CAAC,UAAU,CAAC,YAAY,CAAC,CACzG,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/routes/endpoints/probes.d.ts

@@ -0,0 +1,74 @@
+import { router } from "@powersync/lib-services-framework";
+export declare enum ProbeRoutes {
+    STARTUP = "/probes/startup",
+    LIVENESS = "/probes/liveness",
+    READINESS = "/probes/readiness"
+}
+export declare const startupCheck: router.Endpoint<unknown, router.RouterResponse<{
+    ready: boolean;
+    started: boolean;
+    touched_at: Date;
+}>, import("../router.js").Context, import("../router.js").RequestEndpointHandlerPayload<unknown, import("../router.js").Context, import("../router.js").BasicRouterRequest>, router.EndpointHandler<import("../router.js").RequestEndpointHandlerPayload<unknown, import("../router.js").Context, import("../router.js").BasicRouterRequest>, router.RouterResponse<{
+    ready: boolean;
+    started: boolean;
+    touched_at: Date;
+}>>> & {
+    path: ProbeRoutes;
+    method: router.HTTPMethod.GET;
+    handler: () => Promise<router.RouterResponse<{
+        ready: boolean;
+        started: boolean;
+        touched_at: Date;
+    }>>;
+};
+export declare const livenessCheck: router.Endpoint<unknown, router.RouterResponse<{
+    ready: boolean;
+    started: boolean;
+    touched_at: Date;
+}>, import("../router.js").Context, import("../router.js").RequestEndpointHandlerPayload<unknown, import("../router.js").Context, import("../router.js").BasicRouterRequest>, router.EndpointHandler<import("../router.js").RequestEndpointHandlerPayload<unknown, import("../router.js").Context, import("../router.js").BasicRouterRequest>, router.RouterResponse<{
+    ready: boolean;
+    started: boolean;
+    touched_at: Date;
+}>>> & {
+    path: ProbeRoutes;
+    method: router.HTTPMethod.GET;
+    handler: () => Promise<router.RouterResponse<{
+        ready: boolean;
+        started: boolean;
+        touched_at: Date;
+    }>>;
+};
+export declare const readinessCheck: router.Endpoint<unknown, router.RouterResponse<{
+    ready: boolean;
+    started: boolean;
+    touched_at: Date;
+}>, import("../router.js").Context, import("../router.js").RequestEndpointHandlerPayload<unknown, import("../router.js").Context, import("../router.js").BasicRouterRequest>, router.EndpointHandler<import("../router.js").RequestEndpointHandlerPayload<unknown, import("../router.js").Context, import("../router.js").BasicRouterRequest>, router.RouterResponse<{
+    ready: boolean;
+    started: boolean;
+    touched_at: Date;
+}>>> & {
+    path: ProbeRoutes;
+    method: router.HTTPMethod.GET;
+    handler: () => Promise<router.RouterResponse<{
+        ready: boolean;
+        started: boolean;
+        touched_at: Date;
+    }>>;
+};
+export declare const PROBES_ROUTES: (router.Endpoint<unknown, router.RouterResponse<{
+    ready: boolean;
+    started: boolean;
+    touched_at: Date;
+}>, import("../router.js").Context, import("../router.js").RequestEndpointHandlerPayload<unknown, import("../router.js").Context, import("../router.js").BasicRouterRequest>, router.EndpointHandler<import("../router.js").RequestEndpointHandlerPayload<unknown, import("../router.js").Context, import("../router.js").BasicRouterRequest>, router.RouterResponse<{
+    ready: boolean;
+    started: boolean;
+    touched_at: Date;
+}>>> & {
+    path: ProbeRoutes;
+    method: router.HTTPMethod.GET;
+    handler: () => Promise<router.RouterResponse<{
+        ready: boolean;
+        started: boolean;
+        touched_at: Date;
+    }>>;
+})[];

package/dist/routes/endpoints/probes.js

@@ -0,0 +1,51 @@
+import { container, router } from "@powersync/lib-services-framework";
+import { routeDefinition } from "../router.js";
+export var ProbeRoutes;
+(function (ProbeRoutes) {
+    ProbeRoutes["STARTUP"] = "/probes/startup";
+    ProbeRoutes["LIVENESS"] = "/probes/liveness";
+    ProbeRoutes["READINESS"] = "/probes/readiness";
+})(ProbeRoutes || (ProbeRoutes = {}));
+export const startupCheck = routeDefinition({
+    path: ProbeRoutes.STARTUP,
+    method: router.HTTPMethod.GET,
+    handler: async () => {
+        const state = container.probes.state();
+        return new router.RouterResponse({
+            status: state.started ? 200 : 400,
+            data: {
+                ...state,
+            }
+        });
+    }
+});
+export const livenessCheck = routeDefinition({
+    path: ProbeRoutes.LIVENESS,
+    method: router.HTTPMethod.GET,
+    handler: async () => {
+        const state = container.probes.state();
+        const timeDifference = Date.now() - state.touched_at.getTime();
+        const status = timeDifference < 10000 ? 200 : 400;
+        return new router.RouterResponse({
+            status,
+            data: {
+                ...state,
+            }
+        });
+    }
+});
+export const readinessCheck = routeDefinition({
+    path: ProbeRoutes.READINESS,
+    method: router.HTTPMethod.GET,
+    handler: async () => {
+        const state = container.probes.state();
+        return new router.RouterResponse({
+            status: state.ready ? 200 : 400,
+            data: {
+                ...state,
+            }
+        });
+    }
+});
+export const PROBES_ROUTES = [startupCheck, livenessCheck, readinessCheck];
+//# sourceMappingURL=probes.js.map

package/dist/routes/endpoints/probes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probes.js","sourceRoot":"","sources":["../../../src/routes/endpoints/probes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,0CAA2B,CAAA;IAC3B,4CAA6B,CAAA;IAC7B,8CAA+B,CAAA;AACjC,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC;IAC1C,IAAI,EAAE,WAAW,CAAC,OAAO;IACzB,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG;IAC7B,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAEvC,OAAO,IAAI,MAAM,CAAC,cAAc,CAAC;YAC/B,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;YACjC,IAAI,EAAE;gBACJ,GAAG,KAAK;aACT;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;IAC3C,IAAI,EAAE,WAAW,CAAC,QAAQ;IAC1B,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG;IAC7B,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAEvC,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAA;QAC9D,MAAM,MAAM,GAAG,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAElD,OAAO,IAAI,MAAM,CAAC,cAAc,CAAC;YAC/B,MAAM;YACN,IAAI,EAAE;gBACJ,GAAG,KAAK;aACT;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC;IAC5C,IAAI,EAAE,WAAW,CAAC,SAAS;IAC3B,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG;IAC7B,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAEvC,OAAO,IAAI,MAAM,CAAC,cAAc,CAAC;YAC/B,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;YAC/B,IAAI,EAAE;gBACJ,GAAG,KAAK;aACT;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,YAAY,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC"}

package/dist/routes/router.d.ts

@@ -1,13 +1,13 @@
 import { router } from '@powersync/lib-services-framework';
-import * as auth from '../auth/auth-index.js';
-import { CorePowerSyncSystem } from '../system/CorePowerSyncSystem.js';
+import type { JwtPayload } from '../auth/auth-index.js';
+import type { CorePowerSyncSystem } from '../system/CorePowerSyncSystem.js';
 /**
  * Common context for routes
  */
 export type Context = {
     user_id?: string;
     system: CorePowerSyncSystem;
-    token_payload?: auth.JwtPayload;
+    token_payload?: JwtPayload;
     token_errors?: string[];
     /**
      * Only on websocket endpoints.

package/package.json

@@ -5,7 +5,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.8.6",
+  "version": "0.8.8",
   "main": "dist/index.js",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",
@@ -34,8 +34,8 @@
     "winston": "^3.13.0",
     "yaml": "^2.3.2",
     "@powersync/lib-services-framework": "0.1.1",
-    "@powersync/service-jpgwire": "0.17.14",
     "@powersync/service-jsonbig": "0.17.10",
+    "@powersync/service-jpgwire": "0.17.14",
     "@powersync/service-rsocket-router": "0.0.13",
     "@powersync/service-sync-rules": "0.20.0",
     "@powersync/service-types": "0.2.0"
@@ -54,6 +54,6 @@
     "build": "tsc -b",
     "build:tests": "tsc -b test/tsconfig.json",
     "test": "vitest --no-threads",
-    "clean": "rm -rf ./lib && tsc -b --clean"
+    "clean": "rm -rf ./dist && tsc -b --clean"
   }
 }

package/src/routes/configure-fastify.ts

@@ -5,6 +5,7 @@ import * as system from '../system/system-index.js';
 
 import { ADMIN_ROUTES } from './endpoints/admin.js';
 import { CHECKPOINT_ROUTES } from './endpoints/checkpointing.js';
+import { PROBES_ROUTES } from './endpoints/probes.js';
 import { SYNC_RULES_ROUTES } from './endpoints/sync-rules.js';
 import { SYNC_STREAM_ROUTES } from './endpoints/sync-stream.js';
 import { createRequestQueueHook, CreateRequestQueueParams } from './hooks.js';
@@ -35,7 +36,7 @@ export type FastifyServerConfig = {
 
 export const DEFAULT_ROUTE_OPTIONS = {
   api: {
-    routes: [...ADMIN_ROUTES, ...CHECKPOINT_ROUTES, ...SYNC_RULES_ROUTES],
+    routes: [...ADMIN_ROUTES, ...CHECKPOINT_ROUTES, ...SYNC_RULES_ROUTES, ...PROBES_ROUTES],
     queueOptions: {
       concurrency: 10,
       max_queue_depth: 20

package/src/routes/endpoints/probes.ts

@@ -0,0 +1,58 @@
+import { container, router } from "@powersync/lib-services-framework";
+import { routeDefinition } from "../router.js";
+
+export enum ProbeRoutes {
+  STARTUP = '/probes/startup',
+  LIVENESS = '/probes/liveness',
+  READINESS = '/probes/readiness'
+}
+
+export const startupCheck = routeDefinition({
+  path: ProbeRoutes.STARTUP,
+  method: router.HTTPMethod.GET,
+  handler: async () => {
+    const state = container.probes.state();
+
+    return new router.RouterResponse({
+      status: state.started ? 200 : 400,
+      data: {
+        ...state,
+      }
+    });
+  }
+});
+
+export const livenessCheck = routeDefinition({
+  path: ProbeRoutes.LIVENESS,
+  method: router.HTTPMethod.GET,
+  handler: async () => {
+    const state = container.probes.state();
+
+    const timeDifference = Date.now() - state.touched_at.getTime()
+    const status = timeDifference < 10000 ? 200 : 400;
+
+    return new router.RouterResponse({
+      status,
+      data: {
+        ...state,
+      }
+    });
+  }
+});
+
+export const readinessCheck = routeDefinition({
+  path: ProbeRoutes.READINESS,
+  method: router.HTTPMethod.GET,
+  handler: async () => {
+    const state = container.probes.state();
+
+    return new router.RouterResponse({
+      status: state.ready ? 200 : 400,
+      data: {
+        ...state,
+      }
+    });
+  }
+});
+
+export const PROBES_ROUTES = [startupCheck, livenessCheck, readinessCheck];

package/src/routes/router.ts

@@ -1,6 +1,6 @@
 import { router } from '@powersync/lib-services-framework';
-import * as auth from '../auth/auth-index.js';
-import { CorePowerSyncSystem } from '../system/CorePowerSyncSystem.js';
+import type { JwtPayload } from '../auth/auth-index.js';
+import type { CorePowerSyncSystem } from '../system/CorePowerSyncSystem.js';
 
 /**
  * Common context for routes
@@ -9,7 +9,7 @@ export type Context = {
   user_id?: string;
   system: CorePowerSyncSystem;
 
-  token_payload?: auth.JwtPayload;
+  token_payload?: JwtPayload;
   token_errors?: string[];
   /**
    * Only on websocket endpoints.

package/test/src/routes/probes.integration.test.ts

@@ -0,0 +1,231 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import Fastify, { FastifyInstance } from 'fastify';
+import { container } from '@powersync/lib-services-framework';
+import * as auth from '../../../src/routes/auth.js';
+import * as system from '../../../src/system/system-index.js';
+import { configureFastifyServer } from '../../../src/index.js';
+import { ProbeRoutes } from '../../../src/routes/endpoints/probes.js';
+
+vi.mock("@powersync/lib-services-framework", async () => {
+  const actual = await vi.importActual("@powersync/lib-services-framework") as any;
+  return {
+    ...actual,
+    container: {
+      ...actual.container,
+      probes: {
+        state: vi.fn()
+      }
+    },
+  }
+})
+
+describe('Probe Routes Integration', () => {
+  let app: FastifyInstance;
+  let mockSystem: system.CorePowerSyncSystem;
+
+  beforeEach(async () => {
+    app = Fastify();
+    mockSystem = {} as system.CorePowerSyncSystem;
+    await configureFastifyServer(app, { system: mockSystem });
+    await app.ready();
+  });
+
+  afterEach(async () => {
+    await app.close();
+  });
+
+  describe('Startup Probe', () => {
+    it('returns 200 when system is started', async () => {
+      const mockState = {
+        started: true,
+        ready: true,
+        touched_at: new Date()
+      };
+      vi.spyOn(auth, 'authUser').mockResolvedValue({ authorized: true });
+      vi.mocked(container.probes.state).mockReturnValue(mockState);
+
+      const response = await app.inject({
+        method: 'GET',
+        url: ProbeRoutes.STARTUP,
+      });
+
+      expect(response.statusCode).toBe(200);
+      expect(JSON.parse(response.payload)).toEqual({
+        ...mockState,
+        touched_at: mockState.touched_at.toISOString()
+      });
+    });
+
+    it('returns 400 when system is not started', async () => {
+      const mockState = {
+        started: false,
+        ready: false,
+        touched_at: new Date()
+      };
+
+      vi.mocked(container.probes.state).mockReturnValue(mockState);
+
+      const response = await app.inject({
+        method: 'GET',
+        url: ProbeRoutes.STARTUP,
+      });
+
+      expect(response.statusCode).toBe(400);
+      expect(JSON.parse(response.payload)).toEqual({
+        ...mockState,
+        touched_at: mockState.touched_at.toISOString()
+      });
+    });
+  });
+
+  describe('Liveness Probe', () => {
+    it('returns 200 when system was touched recently', async () => {
+      const mockState = {
+        started: true,
+        ready: true,
+        touched_at: new Date()
+      };
+
+      vi.mocked(container.probes.state).mockReturnValue(mockState);
+
+      const response = await app.inject({
+        method: 'GET',
+        url: ProbeRoutes.LIVENESS,
+      });
+
+      expect(response.statusCode).toBe(200);
+      expect(JSON.parse(response.payload)).toEqual({
+        ...mockState,
+        touched_at: mockState.touched_at.toISOString()
+      });
+    });
+
+    it('returns 400 when system has not been touched recently', async () => {
+      const mockState = {
+        started: true,
+        ready: true,
+        touched_at: new Date(Date.now() - 15000) // 15 seconds ago
+      };
+
+      vi.mocked(container.probes.state).mockReturnValue(mockState);
+
+      const response = await app.inject({
+        method: 'GET',
+        url: ProbeRoutes.LIVENESS,
+      });
+
+      expect(response.statusCode).toBe(400);
+      expect(JSON.parse(response.payload)).toEqual({
+        ...mockState,
+        touched_at: mockState.touched_at.toISOString()
+      });
+    });
+  });
+
+  describe('Readiness Probe', () => {
+    it('returns 200 when system is ready', async () => {
+      const mockState = {
+        started: true,
+        ready: true,
+        touched_at: new Date()
+      };
+
+      vi.mocked(container.probes.state).mockReturnValue(mockState);
+
+      const response = await app.inject({
+        method: 'GET',
+        url: ProbeRoutes.READINESS,
+      });
+
+      expect(response.statusCode).toBe(200);
+      expect(JSON.parse(response.payload)).toEqual({
+        ...mockState,
+        touched_at: mockState.touched_at.toISOString()
+      });
+    });
+
+    it('returns 400 when system is not ready', async () => {
+      const mockState = {
+        started: true,
+        ready: false,
+        touched_at: new Date()
+      };
+
+      vi.mocked(container.probes.state).mockReturnValue(mockState);
+
+      const response = await app.inject({
+        method: 'GET',
+        url: ProbeRoutes.READINESS,
+      });
+
+      expect(response.statusCode).toBe(400);
+      expect(JSON.parse(response.payload)).toEqual({
+        ...mockState,
+        touched_at: mockState.touched_at.toISOString()
+      });
+    });
+  });
+
+  describe('Request Queue Behavior', () => {
+    it('handles concurrent requests within limits', async () => {
+      const mockState = { started: true, ready: true, touched_at: new Date() };
+      vi.mocked(container.probes.state).mockReturnValue(mockState);
+
+      // Create array of 15 concurrent requests (default concurrency is 10)
+      const requests = Array(15).fill(null).map(() =>
+        app.inject({
+          method: 'GET',
+          url: ProbeRoutes.STARTUP,
+        })
+      );
+
+      const responses = await Promise.all(requests);
+
+      // All requests should complete successfully
+      responses.forEach(response => {
+        expect(response.statusCode).toBe(200);
+        expect(JSON.parse(response.payload)).toEqual({
+          ...mockState,
+          touched_at: mockState.touched_at.toISOString()
+        });
+      });
+    });
+
+    it('respects max queue depth', async () => {
+      const mockState = { started: true, ready: true, touched_at: new Date() };
+      vi.mocked(container.probes.state).mockReturnValue(mockState);
+
+      // Create array of 35 concurrent requests (default max_queue_depth is 20)
+      const requests = Array(35).fill(null).map(() =>
+        app.inject({
+          method: 'GET',
+          url: ProbeRoutes.STARTUP,
+        })
+      );
+
+      const responses = await Promise.all(requests);
+
+      // Some requests should succeed and some should fail with 429
+      const successCount = responses.filter(r => r.statusCode === 200).length;
+      const queueFullCount = responses.filter(r => r.statusCode === 429).length;
+
+      expect(successCount).toBeGreaterThan(0);
+      expect(queueFullCount).toBeGreaterThan(0);
+      expect(successCount + queueFullCount).toBe(35);
+    });
+  });
+
+  describe('Content Types', () => {
+    it('returns correct content type headers', async () => {
+      const mockState = { started: true, ready: true, touched_at: new Date() };
+      vi.mocked(container.probes.state).mockReturnValue(mockState);
+
+      const response = await app.inject({
+        method: 'GET',
+        url: ProbeRoutes.STARTUP,
+      });
+
+      expect(response.headers['content-type']).toMatch(/application\/json/);
+    });
+  });
+});