@powersync/service-sync-rules 0.35.0 → 0.37.0

package/README.md

@@ -1,17 +1,17 @@
 # powersync-sync-rules
 
-A library containing logic for PowerSync sync rules.
+A library containing logic for PowerSync sync config.
 
 This is not intended to be used directly by users of PowerSync. If you are interested in the internals, read on.
 
 # Overview
 
-A core design constraint is that sync rules define two operations:
+A core design constraint is that the sync config defines two operations:
 
 1. Given a data row, compute a list of buckets that it belongs to.
 2. Given an authenticated user, return a list of buckets for the user.
 
-This implementation of sync rules use SQL queries to declaratively define those operations using familiar SQL operations.
+This implementation of sync config uses SQL queries to declaratively define those operations using familiar SQL operations.
 
 We define (1) using data queries, and (2) using parameter queries.
 

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":"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"}

package/dist/BucketDescription.d.ts

@@ -35,7 +35,7 @@ export type NonEnumerableBucketDataSource = NonEnumerableSourceClass;
 export interface BucketDescription extends NonEnumerableBucketDataSource {
     /**
      * The id of the bucket, which is derived from the name of the bucket's definition
-     * in the sync rules as well as the values returned by the parameter queries.
+     * in the sync config as well as the values returned by the parameter queries.
      */
     bucket: string;
     /**

package/dist/BucketParameterQuerier.d.ts

@@ -68,7 +68,17 @@ export interface PendingQueriers {
     errors: QuerierError[];
 }
 export interface ParameterLookupSource {
-    getParameterSets: (lookups: ScopedParameterLookup[]) => Promise<SqliteJsonRow[]>;
+    getParameterSets: (lookups: ScopedParameterLookup[], debugDefinition: string) => Promise<ParameterLookupRows[]>;
+}
+export interface ParameterLookupRows {
+    /**
+     * A lookup passed to {@link ParameterLookupSource.getParameterSets}.
+     */
+    lookup: ScopedParameterLookup;
+    /**
+     * Rows returned from the {@link lookup}.
+     */
+    rows: SqliteJsonRow[];
 }
 export interface QueryBucketDescriptorOptions extends ParameterLookupSource {
     parameters: RequestParameters;
@@ -88,6 +98,18 @@ export declare class ScopedParameterLookup {
      * The result of this getter is cached to avoid re-computing the JSON value for lookups that get reused.
      */
     get serializedRepresentation(): string;
+    /**
+     * Index id.
+     *
+     * This depends on the lookup being constructed with lookupName = indexId, and queryId = ''.
+     */
+    get indexId(): string;
+    /**
+     * Returns the "key" portion of the lookup values.
+     *
+     * This is this.values, excluding the first "lookupName" and "queryId".
+     */
+    get indexKey(): SqliteJsonValue[];
     static normalized(scope: ParameterLookupScope, lookup: UnscopedParameterLookup): ScopedParameterLookup;
     /**
      * Primarily for test fixtures.

package/dist/BucketParameterQuerier.js

@@ -33,6 +33,30 @@ export class ScopedParameterLookup {
     get serializedRepresentation() {
         return (this.#cachedSerializedForm ??= JSONBig.stringify(this.values));
     }
+    /**
+     * Index id.
+     *
+     * This depends on the lookup being constructed with lookupName = indexId, and queryId = ''.
+     */
+    get indexId() {
+        const indexId = this.values[0];
+        // TODO: Consider restructuring so that these values aren't present at all
+        if (this.values[1] != '') {
+            throw new Error('Unexpected queryId');
+        }
+        else if (typeof indexId != 'string') {
+            throw new Error('Unexpected indexId');
+        }
+        return indexId;
+    }
+    /**
+     * Returns the "key" portion of the lookup values.
+     *
+     * This is this.values, excluding the first "lookupName" and "queryId".
+     */
+    get indexKey() {
+        return this.values.slice(2);
+    }
     static normalized(scope, lookup) {
         return new ScopedParameterLookup(scope.source, [scope.lookupName, scope.queryId, ...lookup.lookupValues]);
     }

package/dist/BucketParameterQuerier.js.map

@@ -1 +1 @@
-{"version":3,"file":"BucketParameterQuerier.js","sourceRoot":"","sources":["../src/BucketParameterQuerier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAMrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AA+ErD,MAAM,UAAU,4BAA4B,CAAC,QAAkC;IAC7E,OAAO;QACL,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;QACvD,iBAAiB,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACvE,KAAK,CAAC,8BAA8B,CAAC,MAA6B;YAChE,IAAI,OAAO,GAAqB,EAAE,CAAC;YACnC,KAAK,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACvB,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC;oBACxB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACpE,CAAC;YACH,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,qBAAqB;IAChC,kEAAkE;IACzD,MAAM,CAA6B;IACnC,OAAO,CAA8B;IAE9C,qBAAqB,CAAU;IAE/B;;;;OAIG;IACH,IAAI,wBAAwB;QAC1B,OAAO,CAAC,IAAI,CAAC,qBAAqB,KAAK,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,KAA2B,EAAE,MAA+B;QAC5E,OAAO,IAAI,qBAAqB,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IAC5G,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAA2B,EAAE,MAAyB;QAClE,OAAO,IAAI,qBAAqB,CAAC,KAAK,CAAC,MAAM,EAAE;YAC7C,KAAK,CAAC,UAAU;YAChB,KAAK,CAAC,OAAO;YACb,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,YAAoB,MAAmC,EAAE,MAAyB;QAChF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF;AAED,MAAM,OAAO,uBAAuB;IACzB,YAAY,CAAoB;IAEzC,MAAM,CAAC,UAAU,CAAC,MAAyB;QACzC,OAAO,IAAI,uBAAuB,CAAC,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,YAAY,YAA+B;QACzC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF"}
+{"version":3,"file":"BucketParameterQuerier.js","sourceRoot":"","sources":["../src/BucketParameterQuerier.ts"],"names":[],"mappings":"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"}

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.
  *
@@ -63,7 +74,7 @@ export type ScopedEvaluateParameterRow = (sourceTable: SourceTableInterface, row
  */
 export interface BucketDataSource {
     /**
-     * Unique name of the data source within a sync rules version.
+     * Unique name of the data source within a replication stream.
      *
      * This may be used as the basis for bucketPrefix (or it could be ignored).
      */
@@ -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":"AAAA,OAAO,EAGL,qBAAqB,EAEtB,MAAM,6BAA6B,CAAC;AAQrC,OAAO,EAML,iBAAiB,EAKlB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAoJ9C,MAAM,CAAN,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IAC1B,iEAAS,CAAA;IACT,qEAAW,CAAA;AACb,CAAC,EAHW,gBAAgB,KAAhB,gBAAgB,QAG3B;AAID,SAAS,kBAAkB,CAAC,KAAqB,EAAE,MAAwB;IACzE,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAChE,OAAO,CAAC,OAA2B,EAAsB,EAAE;QACzD,OAAO,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACnD,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9B,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,MAAM,SAAS,GAAiB,gBAAgB,CAC9C;gBACE,MAAM,EAAE,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,0BAA0B;gBAC9D,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;aAClB,EACD,KAAK,CAAC,MAAM,CACb,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAClC,KAAqB,EACrB,MAAmC;IAEnC,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,CAAC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACxE,OAAO,CAAC,WAA2B,EAAE,GAAc,EAA+B,EAAE;QAClF,OAAO,SAAS,CAAC,oBAAoB,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACrE,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9B,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,OAAO;gBACL,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;gBACzC,MAAM,EAAE,qBAAqB,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;aACjC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAqB,EACrB,OAA2B;IAE3B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7E,OAAO;QACL,WAAW,CAAC,OAA2B;YACrC,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACxD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,KAAqB,EACrB,OAAsC;IAEtC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,2BAA2B,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACtF,OAAO;QACL,oBAAoB,CAAC,WAA2B,EAAE,GAAc;YAC9D,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC;QACjE,CAAC;KACF,CAAC;AACJ,CAAC"}

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;
+}