@powersync/service-core 1.26.1 → 1.27.1

package/dist/replication/ReplicationModule.js

@@ -1,6 +1,7 @@
 import * as t from 'ts-codec';
 import { schema } from '@powersync/lib-services-framework';
 import * as types from '@powersync/service-types';
+import * as api from '../api/api-index.js';
 import * as modules from '../modules/modules-index.js';
 /**
  *  A replication module describes all the functionality that PowerSync requires to
@@ -38,9 +39,18 @@ export class ReplicationModule extends modules.AbstractModule {
         const baseMatchingConfig = matchingConfig[0];
         // If decoding fails, this will raise a hard error, and stop the service.
         this.decodeConfig(baseMatchingConfig);
-        context.replicationEngine?.register(this.createReplicator(context));
-        context.routerEngine?.registerAPI(this.createRouteAPIAdapter());
-        await this.onInitialized(context);
+        const sourceAPI = this.createRouteAPIAdapter();
+        // The router exists even in replication-only mode and owns adapter shutdown through the service lifecycle.
+        context.routerEngine.registerAPI(sourceAPI);
+        if (context.replicationEngine) {
+            const replicator = this.createReplicator(context);
+            if (sourceAPI.validateSourceCapabilities != null) {
+                // KLUDGE: Reuse the adapter validation for filesystem-loaded configs.
+                // A shared validation interface could replace this registration through the route adapter in the future.
+                replicator.registerSourceCapabilitiesAssertion((config) => api.assertSourceCapabilities(sourceAPI, config));
+            }
+            context.replicationEngine.register(replicator);
+        }
     }
     decodeConfig(config) {
         this.validateConfig(config);

package/dist/replication/ReplicationModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReplicationModule.js","sourceRoot":"","sources":["../../src/replication/ReplicationModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAE9B,OAAO,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAC3D,OAAO,KAAK,KAAK,MAAM,0BAA0B,CAAC;AAElD,OAAO,KAAK,OAAO,MAAM,6BAA6B,CAAC;AA2BvD;;;GAGG;AACH,MAAM,OAAgB,iBACpB,SAAQ,OAAO,CAAC,cAAc;IAGpB,IAAI,CAAS;IACb,YAAY,CAAa;IACzB,aAAa,CAAsB;IAE7C;;;OAGG;IACH,YAAsB,OAAiC;QACrD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C,CAAC;IAuBD;;OAEG;IACI,KAAK,CAAC,UAAU,CAAC,OAA8B;QACpD,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;YACvC,gEAAgE;YAChE,OAAO;QACT,CAAC;QAED,MAAM,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/G,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;YAC3B,6CAA6C;YAC7C,OAAO;QACT,CAAC;QAED,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,OAAO,CACjB,iCAAiC,IAAI,CAAC,IAAI,2DAA2D,CACtG,CAAC;QACJ,CAAC;QAED,MAAM,kBAAkB,GAAG,cAAc,CAAC,CAAC,CAAY,CAAC;QACxD,yEAAyE;QACzE,IAAI,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;QAEtC,OAAO,CAAC,iBAAiB,EAAE,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;QACpE,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,CAAC;QAEhE,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAES,YAAY,CAAC,MAAe;QACpC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxD,CAAC;IAEO,cAAc,CAAC,MAAe;QACpC,MAAM,SAAS,GAAG,MAAM;aACrB,eAAe;QACd,4DAA4D;QAC5D,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,YAAY,EAAE;YACtC,eAAe,EAAE,IAAI;YACrB,OAAO,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC;SACvC,CAAC,CACH;aACA,SAAS,EAAE,CAAC;QAEf,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEzC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,CAAC,IAAI,mBAAmB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtG,CAAC;IACH,CAAC;IAES,YAAY,CAAC,cAAsB;QAC3C,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,cAAc,EAAE,CAAC;IAC1C,CAAC;CACF"}
+{"version":3,"file":"ReplicationModule.js","sourceRoot":"","sources":["../../src/replication/ReplicationModule.ts"],"names":[],"mappings":"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"}

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

@@ -92,19 +92,22 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
             sync_rules_content?: boolean | undefined;
         }, {
             connections: {
+                id: string;
                 errors: {
-                    level: "warning" | "fatal";
                     message: string;
+                    level: "warning" | "fatal";
                     location?: {
                         start_offset: number;
                         end_offset: number;
                     } | undefined;
                     ts?: string | undefined;
                 }[];
-                id: string;
                 connected: boolean;
                 postgres_uri: string;
             }[];
+            service?: {
+                version: string;
+            } | undefined;
             active_sync_rules?: {
                 errors: {
                     level: "warning" | "fatal";
@@ -191,25 +194,29 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
                 version_label?: string | null | undefined;
                 content?: string | undefined;
             } | undefined;
+            sync_config_source?: "config" | "api" | undefined;
         }, import("./router.js").Context, import("./router.js").RequestEndpointHandlerPayload<{
             sync_rules_content?: boolean | undefined;
         }, import("./router.js").Context, import("./router.js").BasicRouterRequest>, import("@powersync/lib-services-framework").EndpointHandler<import("./router.js").RequestEndpointHandlerPayload<{
             sync_rules_content?: boolean | undefined;
         }, import("./router.js").Context, import("./router.js").BasicRouterRequest>, {
             connections: {
+                id: string;
                 errors: {
-                    level: "warning" | "fatal";
                     message: string;
+                    level: "warning" | "fatal";
                     location?: {
                         start_offset: number;
                         end_offset: number;
                     } | undefined;
                     ts?: string | undefined;
                 }[];
-                id: string;
                 connected: boolean;
                 postgres_uri: string;
             }[];
+            service?: {
+                version: string;
+            } | undefined;
             active_sync_rules?: {
                 errors: {
                     level: "warning" | "fatal";
@@ -296,6 +303,7 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
                 version_label?: string | null | undefined;
                 content?: string | undefined;
             } | undefined;
+            sync_config_source?: "config" | "api" | undefined;
         }>> & {
             path: string;
             method: import("@powersync/lib-services-framework").HTTPMethod.POST;
@@ -313,19 +321,22 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
                 sync_rules_content?: boolean | undefined;
             }, import("./router.js").Context, import("./router.js").BasicRouterRequest>) => Promise<{
                 connections: {
+                    id: string;
                     errors: {
-                        level: "warning" | "fatal";
                         message: string;
+                        level: "warning" | "fatal";
                         location?: {
                             start_offset: number;
                             end_offset: number;
                         } | undefined;
                         ts?: string | undefined;
                     }[];
-                    id: string;
                     connected: boolean;
                     postgres_uri: string;
                 }[];
+                service?: {
+                    version: string;
+                } | undefined;
                 active_sync_rules?: {
                     errors: {
                         level: "warning" | "fatal";
@@ -412,8 +423,10 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
                     version_label?: string | null | undefined;
                     content?: string | undefined;
                 } | undefined;
+                sync_config_source?: "config" | "api" | undefined;
             }>;
         }) | (import("@powersync/lib-services-framework").Endpoint<{}, {
+            defaultSchema: string;
             connections: {
                 tag: string;
                 schemas: {
@@ -422,9 +435,9 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
                         name: string;
                         columns: {
                             name: string;
+                            type: string;
                             sqlite_type: number | import("@powersync/service-types").SqliteSchemaTypeText;
                             internal_type: string;
-                            type: string;
                             pg_type: string;
                             description?: string | undefined;
                         }[];
@@ -432,9 +445,9 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
                 }[];
                 id?: string | undefined;
             }[];
-            defaultSchema: string;
             defaultConnectionTag: string;
         }, import("./router.js").Context, import("./router.js").RequestEndpointHandlerPayload<{}, import("./router.js").Context, import("./router.js").BasicRouterRequest>, import("@powersync/lib-services-framework").EndpointHandler<import("./router.js").RequestEndpointHandlerPayload<{}, import("./router.js").Context, import("./router.js").BasicRouterRequest>, {
+            defaultSchema: string;
             connections: {
                 tag: string;
                 schemas: {
@@ -443,9 +456,9 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
                         name: string;
                         columns: {
                             name: string;
+                            type: string;
                             sqlite_type: number | import("@powersync/service-types").SqliteSchemaTypeText;
                             internal_type: string;
-                            type: string;
                             pg_type: string;
                             description?: string | undefined;
                         }[];
@@ -453,7 +466,6 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
                 }[];
                 id?: string | undefined;
             }[];
-            defaultSchema: string;
             defaultConnectionTag: string;
         }>> & {
             path: string;
@@ -467,6 +479,7 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
             };
             validator: import("@powersync/lib-services-framework").MicroValidator<{}, string[]>;
             handler: (payload: import("./router.js").RequestEndpointHandlerPayload<{}, import("./router.js").Context, import("./router.js").BasicRouterRequest>) => Promise<{
+                defaultSchema: string;
                 connections: {
                     tag: string;
                     schemas: {
@@ -475,9 +488,9 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
                             name: string;
                             columns: {
                                 name: string;
+                                type: string;
                                 sqlite_type: number | import("@powersync/service-types").SqliteSchemaTypeText;
                                 internal_type: string;
-                                type: string;
                                 pg_type: string;
                                 description?: string | undefined;
                             }[];
@@ -485,7 +498,6 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
                     }[];
                     id?: string | undefined;
                 }[];
-                defaultSchema: string;
                 defaultConnectionTag: string;
             }>;
         }) | (import("@powersync/lib-services-framework").Endpoint<{}, {
@@ -522,8 +534,8 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
             sync_rules: string;
         }, {
             errors: {
-                level: "warning" | "fatal";
                 message: string;
+                level: "warning" | "fatal";
                 location?: {
                     start_offset: number;
                     end_offset: number;
@@ -536,18 +548,18 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
                 tables: {
                     name: string;
                     schema: string;
-                    replication_id: string[];
-                    data_queries: boolean;
-                    parameter_queries: boolean;
                     errors: {
-                        level: "warning" | "fatal";
                         message: string;
+                        level: "warning" | "fatal";
                         location?: {
                             start_offset: number;
                             end_offset: number;
                         } | undefined;
                         ts?: string | undefined;
                     }[];
+                    replication_id: string[];
+                    data_queries: boolean;
+                    parameter_queries: boolean;
                     pattern?: string | undefined;
                 }[];
                 slot_name: string;
@@ -568,8 +580,8 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
             sync_rules: string;
         }, import("./router.js").Context, import("./router.js").BasicRouterRequest>, {
             errors: {
-                level: "warning" | "fatal";
                 message: string;
+                level: "warning" | "fatal";
                 location?: {
                     start_offset: number;
                     end_offset: number;
@@ -582,18 +594,18 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
                 tables: {
                     name: string;
                     schema: string;
-                    replication_id: string[];
-                    data_queries: boolean;
-                    parameter_queries: boolean;
                     errors: {
-                        level: "warning" | "fatal";
                         message: string;
+                        level: "warning" | "fatal";
                         location?: {
                             start_offset: number;
                             end_offset: number;
                         } | undefined;
                         ts?: string | undefined;
                     }[];
+                    replication_id: string[];
+                    data_queries: boolean;
+                    parameter_queries: boolean;
                     pattern?: string | undefined;
                 }[];
                 slot_name: string;
@@ -625,8 +637,8 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
                 sync_rules: string;
             }, import("./router.js").Context, import("./router.js").BasicRouterRequest>) => Promise<{
                 errors: {
-                    level: "warning" | "fatal";
                     message: string;
+                    level: "warning" | "fatal";
                     location?: {
                         start_offset: number;
                         end_offset: number;
@@ -639,18 +651,18 @@ export declare const DEFAULT_ROUTE_OPTIONS: {
                     tables: {
                         name: string;
                         schema: string;
-                        replication_id: string[];
-                        data_queries: boolean;
-                        parameter_queries: boolean;
                         errors: {
-                            level: "warning" | "fatal";
                             message: string;
+                            level: "warning" | "fatal";
                             location?: {
                                 start_offset: number;
                                 end_offset: number;
                             } | undefined;
                             ts?: string | undefined;
                         }[];
+                        replication_id: string[];
+                        data_queries: boolean;
+                        parameter_queries: boolean;
                         pattern?: string | undefined;
                     }[];
                     slot_name: string;