@powersync/service-sync-rules 0.36.0 → 0.37.0

package/dist/BaseSqlDataQuery.d.ts

@@ -1,7 +1,7 @@
 import { SelectedColumn } from 'pgsql-ast-parser';
 import { SqlRuleError } from './errors.js';
 import { ColumnDefinition } from './ExpressionType.js';
-import { SourceTableInterface } from './SourceTableInterface.js';
+import { SourceTableRef } from './SourceTableRef.js';
 import { AvailableTable, SqlTools } from './sql_filters.js';
 import { TablePattern } from './TablePattern.js';
 import { QueryParameters, QuerySchema, SourceSchema, SourceSchemaTable, SqliteJsonRow, SqliteRow, UnscopedEvaluationResult } from './types.js';
@@ -10,7 +10,7 @@ export interface RowValueExtractor {
     getTypes(schema: QuerySchema, into: Record<string, ColumnDefinition>): void;
 }
 export interface EvaluateRowOptions {
-    table: SourceTableInterface;
+    table: SourceTableRef;
     row: SqliteRow;
     serializedBucketParameters: (params: QueryParameters) => string[];
 }
@@ -62,8 +62,8 @@ export declare class BaseSqlDataQuery {
     private readonly tools;
     readonly errors: SqlRuleError[];
     constructor(options: BaseSqlDataQueryOptions);
-    applies(table: SourceTableInterface): boolean;
-    addSpecialParameters(table: SourceTableInterface, row: SqliteRow): SqliteRow;
+    applies(table: SourceTableRef): boolean;
+    addSpecialParameters(table: SourceTableRef, row: SqliteRow): SqliteRow;
     getOutputName(sourceTable: string): string;
     isUnaliasedWildcard(): boolean;
     columnOutputNames(): string[];

package/dist/BaseSqlDataQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"BaseSqlDataQuery.js","sourceRoot":"","sources":["../src/BaseSqlDataQuery.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BaseSqlDataQuery.js","sourceRoot":"","sources":["../src/BaseSqlDataQuery.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAgBvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAwB3C,MAAM,OAAO,gBAAgB;IAC3B;;OAEG;IACM,WAAW,CAAe;IAEnC;;;;OAIG;IACM,KAAK,CAAiB;IAE/B;;OAEG;IACM,GAAG,CAAS;IAErB;;OAEG;IACM,OAAO,CAAmB;IAEnC;;;;OAIG;IACM,UAAU,CAAsB;IAEzC;;;;;OAKG;IACM,gBAAgB,CAAW;IACpC;;OAEG;IACc,KAAK,CAAW;IAExB,MAAM,CAAiB;IAEhC,YAAY,OAAgC;QAC1C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;QACjD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACrC,CAAC;IAED,OAAO,CAAC,KAAqB;QAC3B,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,oBAAoB,CAAC,KAAqB,EAAE,GAAc;QACxD,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;YAChC,OAAO;gBACL,GAAG,GAAG;gBACN,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;aACnD,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IAED,aAAa,CAAC,WAAmB;QAC/B,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAC/B,sCAAsC;YACtC,OAAO,WAAW,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;IAC9D,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB,CAAC,MAAoB;QACnC,IAAI,MAAM,GAAoD,EAAE,CAAC;QAEjE,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAC/B,mBAAmB;YACnB,KAAK,IAAI,WAAW,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC3D,IAAI,MAAM,GAAqC,EAAE,CAAC;gBAElD,IAAI,CAAC,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;gBAE9C,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC;oBAC1C,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;iBAC/B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;aAAM,CAAC;YACN,iBAAiB;YACjB,IAAI,MAAM,GAAqC,EAAE,CAAC;YAClD,KAAK,IAAI,WAAW,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC3D,IAAI,CAAC,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAChD,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;gBACxB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;aAC/B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,iBAAiB,CAAC,MAAoB,EAAE,MAAwD;QAC9F,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAChD,KAAK,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1B,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBACjC,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;oBACxB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC;gBAC7C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,sBAAsB,CAAC,OAA2B;QAChD,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,0BAA0B,EAAE,GAAG,OAAO,CAAC;YAE3D,MAAM,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YACpF,2DAA2D;YAC3D,MAAM,wBAAwB,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;YACpE,IAAI,wBAAwB,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACzC,gFAAgF;gBAChF,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACvC,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEnD,OAAO,wBAAwB,CAAC,GAAG,CAAC,CAAC,0BAA0B,EAAE,EAAE;gBACjE,OAAO;oBACL,0BAA0B;oBAC1B,KAAK,EAAE,WAAW;oBAClB,EAAE,EAAE,EAAE;oBACN,IAAI;iBAC0B,CAAC;YACnC,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,IAAI,8BAA8B,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAES,YAAY,CAAC,MAAuB;QAC5C,IAAI,MAAM,GAAc,EAAE,CAAC;QAC3B,KAAK,IAAI,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACtC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAES,mBAAmB,CAAC,WAA8B,EAAE,MAAwC;QACpG,MAAM,WAAW,GAAgB;YAC/B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;gBAC3B,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;oBACrC,OAAO,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBACvC,CAAC;qBAAM,CAAC;oBACN,2BAA2B;oBAC3B,OAAO,SAAS,CAAC;gBACnB,CAAC;YACH,CAAC;YACD,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;gBACpB,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;oBACrC,OAAO,WAAW,CAAC,UAAU,EAAE,CAAC;gBAClC,CAAC;qBAAM,CAAC;oBACN,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC;SACF,CAAC;QACF,KAAK,IAAI,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACtC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;CACF"}

package/dist/BucketSource.d.ts

@@ -1,13 +1,24 @@
 import { PendingQueriers } from './BucketParameterQuerier.js';
 import { ColumnDefinition } from './ExpressionType.js';
-import { HydrationState, ParameterLookupScope } from './HydrationState.js';
-import { SourceTableInterface } from './SourceTableInterface.js';
+import { HydrationState, ParameterLookupDefinitionId } from './HydrationState.js';
+import { SourceTableRef } from './SourceTableRef.js';
 import { GetQuerierOptions } from './SqlSyncRules.js';
+import { ScalarExpressionEngine } from './sync_plan/engine/scalar_expression_engine.js';
+import { SQLite } from './sync_plan/engine/sqlite.js';
 import { TablePattern } from './TablePattern.js';
 import { EvaluatedParametersResult, EvaluateRowOptions, EvaluationResult, SourceSchema, SqliteRow, UnscopedEvaluatedParametersResult, UnscopedEvaluationResult } from './types.js';
 export interface CreateSourceParams {
     hydrationState: HydrationState;
 }
+export interface HydrateSyncConfigParams extends CreateSourceParams {
+    /**
+     * The SQLite engine to use to evaluate scalar expressions in Sync Streams.
+     */
+    sqlite: SQLite | null;
+}
+export interface HydrationInput extends CreateSourceParams {
+    scalarExpressions: ScalarExpressionEngine;
+}
 /**
  * A BucketSource is a _logical_ bucket or sync stream definition. It is primarily used to group together
  * related BucketDataSource, BucketParameterLookupSource and BucketParameterQuerierSource definitions,
@@ -35,7 +46,7 @@ export interface BucketSource {
      */
     readonly parameterIndexLookupCreators: ParameterIndexLookupCreator[];
     debugRepresentation(): any;
-    hydrate(params: CreateSourceParams): HydratedBucketSource;
+    hydrate(params: HydrationInput): HydratedBucketSource;
 }
 /**
  * Internal interface for individual queriers. This is not used on its in the public API directly, apart
@@ -54,7 +65,7 @@ export interface HydratedBucketSource extends BucketParameterQuerierSource {
     readonly definition: BucketSource;
 }
 export type ScopedEvaluateRow = (options: EvaluateRowOptions) => EvaluationResult[];
-export type ScopedEvaluateParameterRow = (sourceTable: SourceTableInterface, row: SqliteRow) => EvaluatedParametersResult[];
+export type ScopedEvaluateParameterRow = (sourceTable: SourceTableRef, row: SqliteRow) => EvaluatedParametersResult[];
 /**
  * Encodes a static definition of a bucket source, as parsed from sync rules or stream definitions.
  *
@@ -73,12 +84,8 @@ export interface BucketDataSource {
      */
     readonly bucketParameters: string[];
     getSourceTables(): Set<TablePattern>;
-    tableSyncsData(table: SourceTableInterface): boolean;
-    /**
-     * Given a row as it appears in a table that affects sync data, return buckets, logical table names and transformed
-     * data for rows to add to buckets.
-     */
-    evaluateRow(options: EvaluateRowOptions): UnscopedEvaluationResult[];
+    tableSyncsData(table: SourceTableRef): boolean;
+    createEvaluator(input: HydrationInput): BucketDataEvaluator;
     /**
      * Given a static schema, infer all logical tables and associated columns that appear in buckets defined by this
      * source.
@@ -90,6 +97,13 @@ export interface BucketDataSource {
         query: string;
     }[]>): void;
 }
+export interface BucketDataEvaluator {
+    /**
+     * Given a row as it appears in a table that affects sync data, return buckets, logical table names and transformed
+     * data for rows to add to buckets.
+     */
+    evaluateRow(options: EvaluateRowOptions): UnscopedEvaluationResult[];
+}
 /**
  * This defines how to extract parameter index lookup values from parameter queries or stream subqueries.
  *
@@ -99,10 +113,16 @@ export interface ParameterIndexLookupCreator {
     /**
      * lookupName + queryId is used to uniquely identify parameter queries for parameter storage.
      *
-     * This defines the default values if no transformations are applied.
+     * The values here specifically identify the definition uniquely within a single SyncConfig.
+     * It does not guarantee uniqueness across different SyncConfigs.
      */
-    readonly defaultLookupScope: ParameterLookupScope;
+    readonly sourceId: ParameterLookupDefinitionId;
     getSourceTables(): Set<TablePattern>;
+    /** Whether the table possibly affects the buckets resolved by this source. */
+    tableSyncsParameters(table: SourceTableRef): boolean;
+    createEvaluator(input: HydrationInput): ParameterIndexLookupEvaluator;
+}
+export interface ParameterIndexLookupEvaluator {
     /**
      * Given a row in a source table that affects sync parameters, returns a structure to index which buckets rows should
      * be associated with.
@@ -110,13 +130,7 @@ export interface ParameterIndexLookupCreator {
      * The returned {@link UnscopedParameterLookup} can be referenced by {@link pushBucketParameterQueriers} to allow the storage
      * system to find buckets.
      */
-    evaluateParameterRow(sourceTable: SourceTableInterface, row: SqliteRow): UnscopedEvaluatedParametersResult[];
-    /** Whether the table possibly affects the buckets resolved by this source. */
-    tableSyncsParameters(table: SourceTableInterface): boolean;
-}
-export interface DebugMergedSource extends HydratedBucketSource {
-    evaluateRow: ScopedEvaluateRow;
-    evaluateParameterRow: ScopedEvaluateParameterRow;
+    evaluateParameterRow(sourceTable: SourceTableRef, row: SqliteRow): UnscopedEvaluatedParametersResult[];
 }
 export declare enum BucketSourceType {
     SYNC_RULE = 0,
@@ -126,16 +140,9 @@ export type ResultSetDescription = {
     name: string;
     columns: ColumnDefinition[];
 };
-export declare function hydrateEvaluateRow(hydrationState: HydrationState, source: BucketDataSource): ScopedEvaluateRow;
-export declare function hydrateEvaluateParameterRow(hydrationState: HydrationState, source: ParameterIndexLookupCreator): ScopedEvaluateParameterRow;
-export declare function mergeDataSources(hydrationState: HydrationState, sources: BucketDataSource[]): {
+export declare function mergeDataSources(input: HydrationInput, sources: BucketDataSource[]): {
     evaluateRow: ScopedEvaluateRow;
 };
-export declare function mergeParameterIndexLookupCreators(hydrationState: HydrationState, sources: ParameterIndexLookupCreator[]): {
+export declare function mergeParameterIndexLookupCreators(input: HydrationInput, sources: ParameterIndexLookupCreator[]): {
     evaluateParameterRow: ScopedEvaluateParameterRow;
 };
-/**
- * For production purposes, we typically need to operate on the different sources separately. However, for debugging,
- * it is useful to have a single merged source that can evaluate everything.
- */
-export declare function debugHydratedMergedSource(bucketSource: BucketSource, params?: CreateSourceParams): DebugMergedSource;

package/dist/BucketSource.js

@@ -1,5 +1,4 @@
 import { ScopedParameterLookup } from './BucketParameterQuerier.js';
-import { DEFAULT_HYDRATION_STATE } from './HydrationState.js';
 import { isEvaluationError } from './types.js';
 import { withBucketSource } from './utils.js';
 export var BucketSourceType;
@@ -7,10 +6,11 @@ export var BucketSourceType;
     BucketSourceType[BucketSourceType["SYNC_RULE"] = 0] = "SYNC_RULE";
     BucketSourceType[BucketSourceType["SYNC_STREAM"] = 1] = "SYNC_STREAM";
 })(BucketSourceType || (BucketSourceType = {}));
-export function hydrateEvaluateRow(hydrationState, source) {
-    const scope = hydrationState.getBucketSourceScope(source);
+function hydrateEvaluateRow(input, source) {
+    const evaluator = source.createEvaluator(input);
+    const scope = input.hydrationState.getBucketSourceScope(source);
     return (options) => {
-        return source.evaluateRow(options).map((result) => {
+        return evaluator.evaluateRow(options).map((result) => {
             if (isEvaluationError(result)) {
                 return result;
             }
@@ -24,10 +24,11 @@ export function hydrateEvaluateRow(hydrationState, source) {
         });
     };
 }
-export function hydrateEvaluateParameterRow(hydrationState, source) {
-    const scope = hydrationState.getParameterIndexLookupScope(source);
+function hydrateEvaluateParameterRow(input, source) {
+    const evaluator = source.createEvaluator(input);
+    const scope = input.hydrationState.getParameterIndexLookupScope(source);
     return (sourceTable, row) => {
-        return source.evaluateParameterRow(sourceTable, row).map((result) => {
+        return evaluator.evaluateParameterRow(sourceTable, row).map((result) => {
             if (isEvaluationError(result)) {
                 return result;
             }
@@ -38,37 +39,20 @@ export function hydrateEvaluateParameterRow(hydrationState, source) {
         });
     };
 }
-export function mergeDataSources(hydrationState, sources) {
-    const withScope = sources.map((source) => hydrateEvaluateRow(hydrationState, source));
+export function mergeDataSources(input, sources) {
+    const withScope = sources.map((source) => hydrateEvaluateRow(input, source));
     return {
         evaluateRow(options) {
             return withScope.flatMap((source) => source(options));
         }
     };
 }
-export function mergeParameterIndexLookupCreators(hydrationState, sources) {
-    const withScope = sources.map((source) => hydrateEvaluateParameterRow(hydrationState, source));
+export function mergeParameterIndexLookupCreators(input, sources) {
+    const withScope = sources.map((source) => hydrateEvaluateParameterRow(input, source));
     return {
         evaluateParameterRow(sourceTable, row) {
             return withScope.flatMap((source) => source(sourceTable, row));
         }
     };
 }
-/**
- * For production purposes, we typically need to operate on the different sources separately. However, for debugging,
- * it is useful to have a single merged source that can evaluate everything.
- */
-export function debugHydratedMergedSource(bucketSource, params) {
-    const hydrationState = params?.hydrationState ?? DEFAULT_HYDRATION_STATE;
-    const resolvedParams = { hydrationState };
-    const dataSource = mergeDataSources(hydrationState, bucketSource.dataSources);
-    const parameterLookupSource = mergeParameterIndexLookupCreators(hydrationState, bucketSource.parameterIndexLookupCreators);
-    const hydratedBucketSource = bucketSource.hydrate(resolvedParams);
-    return {
-        definition: bucketSource,
-        evaluateParameterRow: parameterLookupSource.evaluateParameterRow.bind(parameterLookupSource),
-        evaluateRow: dataSource.evaluateRow.bind(dataSource),
-        pushBucketParameterQueriers: hydratedBucketSource.pushBucketParameterQueriers.bind(hydratedBucketSource)
-    };
-}
 //# sourceMappingURL=BucketSource.js.map

package/dist/BucketSource.js.map

@@ -1 +1 @@
-{"version":3,"file":"BucketSource.js","sourceRoot":"","sources":["../src/BucketSource.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BucketSource.js","sourceRoot":"","sources":["../src/BucketSource.ts"],"names":[],"mappings":"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"}

package/dist/HydratedSyncConfig.d.ts

@@ -0,0 +1,80 @@
+import { BucketDataSource } from './BucketSource.js';
+import { BucketSource, CompatibilityContext, EvaluatedParameters, EvaluatedRow, EvaluationError, GetBucketParameterQuerierResult, GetQuerierOptions, HydrateSyncConfigParams, ParameterIndexLookupCreator, SqlEventDescriptor, SqliteInputValue, SqliteValue, SyncConfig, TablePattern } from './index.js';
+import { SourceTableRef } from './SourceTableRef.js';
+import { EvaluateRowOptions, SqliteRow } from './types.js';
+export interface MatchingSources {
+    bucketDataSources: BucketDataSource[];
+    parameterLookupSources: ParameterIndexLookupCreator[];
+}
+/**
+ * HydratedSyncConfig is sync config definitions along with persisted state.
+ *
+ * This may be a single SyncConfig, or multiple SyncConfigs merged together.
+ * In the case of multiple SyncConfigs, they must share the same CompatibilityContext,
+ * but can have different bucket sources.
+ *
+ * The persisted state specifically affects bucket names, as well as V3+ storage structure.
+ */
+export declare class HydratedSyncConfig {
+    #private;
+    /**
+     * These are used by queriers, and do not support merging across multiple SyncConfigs.
+     */
+    private bucketSources;
+    eventDescriptors: SqlEventDescriptor[];
+    /**
+     * Only a single compatibility context is supported across all merged SyncConfigs.
+     */
+    compatibility: CompatibilityContext;
+    /**
+     * The source definitions.
+     *
+     * For most functionality, we don't use these directly, but rather use the
+     * merged definitions such as bucketDataSources.
+     */
+    private readonly sourceDefinitions;
+    /**
+     * Bucket data sources from underlying SyncConfig definitions.
+     */
+    readonly bucketDataSources: BucketDataSource[];
+    readonly bucketParameterLookupSources: ParameterIndexLookupCreator[];
+    private readonly innerEvaluateRow;
+    private readonly innerEvaluateParameterRow;
+    private readonly hydrationInput;
+    private readonly matchingSourcesCache;
+    private mergedEvaluatorCache;
+    private mergedParameterIndexCreatorCache;
+    constructor(params: {
+        definitions: SyncConfig[];
+        createParams: HydrateSyncConfigParams;
+    });
+    get bucketSourceDefinitions(): BucketSource[];
+    getSourceTables(): TablePattern[];
+    tableTriggersEvent(table: SourceTableRef): boolean;
+    tableSyncsData(table: SourceTableRef): boolean;
+    tableSyncsParameters(table: SourceTableRef): boolean;
+    getMatchingSources(source: SourceTableRef): MatchingSources;
+    applyRowContext<MaybeToast extends undefined = never>(source: SqliteRow<SqliteInputValue | MaybeToast>): SqliteRow<SqliteValue | MaybeToast>;
+    /**
+     * Throws errors.
+     */
+    evaluateRow(options: EvaluateRowOptions): EvaluatedRow[];
+    evaluateRowWithErrors(options: EvaluateRowOptions): {
+        results: EvaluatedRow[];
+        errors: EvaluationError[];
+    };
+    /**
+     * Throws errors.
+     */
+    evaluateParameterRow(table: SourceTableRef, row: SqliteRow, options?: {
+        parameterLookupSources?: ParameterIndexLookupCreator[];
+    }): EvaluatedParameters[];
+    evaluateParameterRowWithErrors(table: SourceTableRef, row: SqliteRow, options?: {
+        parameterLookupSources?: ParameterIndexLookupCreator[];
+    }): {
+        results: EvaluatedParameters[];
+        errors: EvaluationError[];
+    };
+    getBucketParameterQuerier(options: GetQuerierOptions): GetBucketParameterQuerierResult;
+    private assertSingleSourceDefinition;
+}

package/dist/HydratedSyncConfig.js

@@ -0,0 +1,207 @@
+import { CompatibilityContext, isEvaluatedParameters, isEvaluatedRow, isEvaluationError, mergeBucketParameterQueriers, mergeDataSources, mergeParameterIndexLookupCreators, parameterLookupScopeKey } from './index.js';
+import { sourceTableRefKey } from './SourceTableRef.js';
+import { createScalarExpressionEngine } from './sync_plan/engine/factory.js';
+import { applyRowContext, uniqueBy } from './utils.js';
+/**
+ * HydratedSyncConfig is sync config definitions along with persisted state.
+ *
+ * This may be a single SyncConfig, or multiple SyncConfigs merged together.
+ * In the case of multiple SyncConfigs, they must share the same CompatibilityContext,
+ * but can have different bucket sources.
+ *
+ * The persisted state specifically affects bucket names, as well as V3+ storage structure.
+ */
+export class HydratedSyncConfig {
+    /**
+     * These are used by queriers, and do not support merging across multiple SyncConfigs.
+     */
+    bucketSources = [];
+    eventDescriptors = [];
+    /**
+     * Only a single compatibility context is supported across all merged SyncConfigs.
+     */
+    compatibility = CompatibilityContext.FULL_BACKWARDS_COMPATIBILITY;
+    /**
+     * The source definitions.
+     *
+     * For most functionality, we don't use these directly, but rather use the
+     * merged definitions such as bucketDataSources.
+     */
+    sourceDefinitions;
+    /**
+     * Bucket data sources from underlying SyncConfig definitions.
+     */
+    bucketDataSources;
+    bucketParameterLookupSources;
+    /**
+     * These are used by queriers, and do not support merging across multiple SyncConfigs.
+     */
+    #bucketSourceDefinitions;
+    innerEvaluateRow;
+    innerEvaluateParameterRow;
+    hydrationInput;
+    matchingSourcesCache = new Map();
+    mergedEvaluatorCache = new WeakMap();
+    mergedParameterIndexCreatorCache = new WeakMap();
+    constructor(params) {
+        const hydrationState = params.createParams.hydrationState;
+        const definitions = params.definitions;
+        if (definitions.length == 0) {
+            throw new Error('HydratedSyncRules requires at least one SyncConfig definition');
+        }
+        this.sourceDefinitions = [...definitions];
+        this.compatibility = assertSharedCompatibility(this.sourceDefinitions);
+        this.hydrationInput = {
+            hydrationState,
+            scalarExpressions: createScalarExpressionEngine(this.compatibility, params.createParams.sqlite)
+        };
+        this.bucketDataSources = uniqueBy(definitions.flatMap((definition) => definition.bucketDataSources), (source) => hydrationState.getBucketSourceScope(source).bucketPrefix);
+        this.bucketParameterLookupSources = uniqueBy(definitions.flatMap((definition) => definition.bucketParameterLookupSources), (source) => parameterLookupScopeKey(hydrationState.getParameterIndexLookupScope(source)));
+        this.innerEvaluateRow = mergeDataSources(this.hydrationInput, this.bucketDataSources).evaluateRow;
+        this.innerEvaluateParameterRow = mergeParameterIndexLookupCreators(this.hydrationInput, this.bucketParameterLookupSources).evaluateParameterRow;
+        this.eventDescriptors = definitions.flatMap((definition) => definition.eventDescriptors);
+        if (definitions.length == 1) {
+            this.#bucketSourceDefinitions = definitions[0].bucketSources;
+            this.bucketSources = this.#bucketSourceDefinitions.map((source) => source.hydrate(this.hydrationInput));
+        }
+        else {
+            // We do not support merging bucket sources across multiple definitions - these are always used with one
+            // SyncConfig at a time.
+            this.#bucketSourceDefinitions = [];
+            this.bucketSources = [];
+        }
+    }
+    get bucketSourceDefinitions() {
+        this.assertSingleSourceDefinition('bucketSourceDefinitions');
+        return this.#bucketSourceDefinitions;
+    }
+    // These methods do not depend on hydration, so we can multiplex them across definitions.
+    getSourceTables() {
+        const sourceTables = new Map();
+        for (const definition of this.sourceDefinitions) {
+            definition.writeSourceTables(sourceTables);
+        }
+        return [...sourceTables.values()];
+    }
+    tableTriggersEvent(table) {
+        return this.sourceDefinitions.some((definition) => definition.tableTriggersEvent(table));
+    }
+    tableSyncsData(table) {
+        return this.sourceDefinitions.some((definition) => definition.tableSyncsData(table));
+    }
+    tableSyncsParameters(table) {
+        return this.sourceDefinitions.some((definition) => definition.tableSyncsParameters(table));
+    }
+    getMatchingSources(source) {
+        const table = {
+            connectionTag: source.connectionTag,
+            schema: source.schema,
+            name: source.name
+        };
+        const key = sourceTableRefKey(table);
+        const cached = this.matchingSourcesCache.get(key);
+        if (cached != null) {
+            return cached;
+        }
+        const matchingSources = {
+            bucketDataSources: this.bucketDataSources.filter((source) => source.tableSyncsData(table)),
+            parameterLookupSources: this.bucketParameterLookupSources.filter((source) => source.tableSyncsParameters(table))
+        };
+        this.matchingSourcesCache.set(key, matchingSources);
+        return matchingSources;
+    }
+    applyRowContext(source) {
+        return applyRowContext(source, this.compatibility);
+    }
+    /**
+     * Throws errors.
+     */
+    evaluateRow(options) {
+        const { results, errors } = this.evaluateRowWithErrors(options);
+        if (errors.length > 0) {
+            throw new Error(errors[0].error);
+        }
+        return results;
+    }
+    evaluateRowWithErrors(options) {
+        let rawResults;
+        if (options.bucketDataSources != null) {
+            // This array is generally expected to be stable, so makes for a good cache key.
+            // It is not a strict requirement to use stable arrays, but it can help for performance.
+            let merged = this.mergedEvaluatorCache.get(options.bucketDataSources);
+            if (merged == null) {
+                merged = mergeDataSources(this.hydrationInput, options.bucketDataSources);
+                this.mergedEvaluatorCache.set(options.bucketDataSources, merged);
+            }
+            rawResults = merged.evaluateRow(options);
+        }
+        else {
+            rawResults = this.innerEvaluateRow(options);
+        }
+        const results = rawResults.filter(isEvaluatedRow);
+        const errors = rawResults.filter(isEvaluationError);
+        return { results, errors };
+    }
+    /**
+     * Throws errors.
+     */
+    evaluateParameterRow(table, row, options) {
+        const { results, errors } = this.evaluateParameterRowWithErrors(table, row, options);
+        if (errors.length > 0) {
+            throw new Error(errors[0].error);
+        }
+        return results;
+    }
+    evaluateParameterRowWithErrors(table, row, options) {
+        let rawResults;
+        if (options?.parameterLookupSources != null) {
+            // This array is generally expected to be stable, so makes for a good cache key.
+            // It is not a strict requirement to use stable arrays, but it can help for performance.
+            let merged = this.mergedParameterIndexCreatorCache.get(options.parameterLookupSources);
+            if (merged == null) {
+                merged = mergeParameterIndexLookupCreators(this.hydrationInput, options.parameterLookupSources);
+                this.mergedParameterIndexCreatorCache.set(options.parameterLookupSources, merged);
+            }
+            rawResults = merged.evaluateParameterRow(table, row);
+        }
+        else {
+            rawResults = this.innerEvaluateParameterRow(table, row);
+        }
+        const results = rawResults.filter(isEvaluatedParameters);
+        const errors = rawResults.filter(isEvaluationError);
+        return { results, errors };
+    }
+    getBucketParameterQuerier(options) {
+        this.assertSingleSourceDefinition('getBucketParameterQuerier()');
+        const queriers = [];
+        const errors = [];
+        const pending = { queriers, errors };
+        for (const source of this.bucketSources) {
+            if ((source.definition.subscribedToByDefault && options.hasDefaultStreams) ||
+                source.definition.name in options.streams) {
+                source.pushBucketParameterQueriers(pending, options);
+            }
+        }
+        const querier = mergeBucketParameterQueriers(queriers);
+        return { querier, errors };
+    }
+    assertSingleSourceDefinition(debugName) {
+        // We may split the types in the future to enforce this on a type level instead of runtime level
+        if (this.sourceDefinitions.length != 1) {
+            throw new Error(`${debugName} is not supported for HydratedSyncRules with multiple SyncConfigs`);
+        }
+    }
+}
+function assertSharedCompatibility(definitions) {
+    const compatibility = definitions[0].compatibility;
+    if (definitions.length == 1) {
+        return compatibility;
+    }
+    for (const definition of definitions) {
+        if (!definition.compatibility.equals(compatibility)) {
+            throw new Error('All SyncConfigs in a HydratedSyncRules instance must use the same CompatibilityContext');
+        }
+    }
+    return compatibility;
+}
+//# sourceMappingURL=HydratedSyncConfig.js.map

package/dist/HydratedSyncConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HydratedSyncConfig.js","sourceRoot":"","sources":["../src/HydratedSyncConfig.ts"],"names":[],"mappings":"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"}

package/dist/HydrationState.d.ts

@@ -1,6 +1,14 @@
 import { BucketDataSource, ParameterIndexLookupCreator } from './BucketSource.js';
+export type BucketDefinitionId = string;
+export type ParameterIndexId = string;
 export interface BucketDataScope {
-    /** The prefix is the bucket name before the parameters. */
+    /**
+     * The prefix is the bucket name before the parameters.
+     *
+     * This also functions as an unique and stable key identifying the bucket source within a single replication stream.
+     *
+     * It may have duplicates over different streams, depending on storage requirements.
+     */
     bucketPrefix: string;
     /** Source used to generate buckets. */
     source: BucketDataSource;
@@ -10,12 +18,19 @@ export interface ParameterLookupScope {
      * The lookup name + queryid is used to reference the parameter lookup record.
      *
      * In newer storage versions, lookupName = indexId, and queryId = ''.
+     *
+     * Together, these also function as an unique and stable key identifying the parameter lookup source within a single replication stream.
+     * They are not guaranteed to be unique across different streams, depending on storage requirements.
      */
     lookupName: string;
     queryId: string;
     /** Source used to generate parameter lookups. */
     source: ParameterIndexLookupCreator;
 }
+export interface ParameterLookupDefinitionId {
+    lookupName: string;
+    queryId: string;
+}
 /**
  * Hydration state information for a source.
  *
@@ -49,5 +64,9 @@ export declare const DEFAULT_HYDRATION_STATE: HydrationState;
  *
  * Note that this transformation has not been present in older versions of the sync service. To preserve backwards
  * compatibility, sync config will not use this without an opt-in.
+ *
+ * This hydration state does not ensure uniqueness of keys across different sync configs, so it cannot be used
+ * for incremental reprocessing / multiple sync configs per replication stream.
  */
 export declare function versionedHydrationState(version: number): HydrationState;
+export declare function parameterLookupScopeKey(scope: ParameterLookupDefinitionId): ParameterIndexId;

package/dist/HydrationState.js

@@ -11,7 +11,10 @@ export const DEFAULT_HYDRATION_STATE = {
         };
     },
     getParameterIndexLookupScope(source) {
-        return source.defaultLookupScope;
+        return {
+            ...source.sourceId,
+            source
+        };
     }
 };
 /**
@@ -25,6 +28,9 @@ export const DEFAULT_HYDRATION_STATE = {
  *
  * Note that this transformation has not been present in older versions of the sync service. To preserve backwards
  * compatibility, sync config will not use this without an opt-in.
+ *
+ * This hydration state does not ensure uniqueness of keys across different sync configs, so it cannot be used
+ * for incremental reprocessing / multiple sync configs per replication stream.
  */
 export function versionedHydrationState(version) {
     return {
@@ -36,8 +42,14 @@ export function versionedHydrationState(version) {
         },
         getParameterIndexLookupScope(source) {
             // No transformations applied here
-            return source.defaultLookupScope;
+            return {
+                ...source.sourceId,
+                source
+            };
         }
     };
 }
+export function parameterLookupScopeKey(scope) {
+    return JSON.stringify([scope.lookupName, scope.queryId]);
+}
 //# sourceMappingURL=HydrationState.js.map