@powersync/service-sync-rules 0.0.0-dev-20260803144812 → 0.0.0-dev-20260929095716

package/dist/SyncConfigParserHooks.d.ts

@@ -0,0 +1,103 @@
+import type { JsonObject } from './json.js';
+import type { SyncConfig } from './SyncConfig.js';
+import type { TablePattern } from './TablePattern.js';
+/**
+ * A decoded config path, for example `['config', 'connections', 'default', 'tables', 'orders', 'filter']`.
+ */
+export type SyncConfigSourcePath = readonly (string | number)[];
+export type SyncConfigSourceLocationTarget = 'key' | 'value';
+/**
+ * Offsets into the authored config, compatible with locations returned by service diagnostics.
+ */
+export interface SyncConfigSourceSpan {
+    start_offset: number;
+    end_offset: number;
+}
+/**
+ * A parser warning or failure, optionally pointing to the relevant config key or value.
+ */
+export interface SyncConfigDiagnostic {
+    level: 'warning' | 'fatal';
+    message: string;
+    location?: SyncConfigSourceSpan;
+}
+export interface SyncConfigSourceLocationResolver {
+    /**
+     * Resolve a field to its source span, falling back to its nearest existing ancestor.
+     */
+    getLocation(path: SyncConfigSourcePath, target?: SyncConfigSourceLocationTarget): SyncConfigSourceSpan | undefined;
+}
+/**
+ * Context for parsing input sync config.
+ */
+export interface SyncConfigParserContext {
+    readonly defaultSchema: string;
+    /**
+     * Candidate being assembled. With throwOnError: false, a partial config may be returned with fatal diagnostics.
+     * Store options on the appropriate config fields.
+     */
+    parsedConfig: SyncConfig;
+    /**
+     * Sources selected by SQL. Additional parsers may inspect these, but cannot add replication sources.
+     */
+    sourceTables: readonly TablePattern[];
+    /**
+     * Utility helpers for determining source locations.
+     */
+    sourceLocations: SyncConfigSourceLocationResolver;
+    /**
+     * Report a diagnostic found while parsing.
+     */
+    reportDiagnostic(diagnostic: SyncConfigDiagnostic): void;
+}
+/**
+ * Context for validating persisted sync config.
+ */
+export interface PersistedSyncConfigParserContext {
+    /**
+     * Default schema used to resolve unqualified table names during validation.
+     * Some callers supply a placeholder; do not persist names qualified using this value.
+     */
+    readonly defaultSchema: string;
+    /**
+     * Report a warning or fatal error found while validating the persisted config.
+     * Include a config source location when available. Fatal errors prevent the config from loading.
+     */
+    reportDiagnostic(diagnostic: SyncConfigDiagnostic): void;
+}
+/**
+ * Additional deterministic parsing/validation, registered per service rather than globally or by connection type.
+ * A hook identifies its own fields and leaves unrelated input alone. Source I/O belongs in source validation.
+ */
+export interface AdditionalSyncConfigParser {
+    /**
+     * A unique ID for the parser. Persisted sync configs store these IDs to validate
+     * if modules which created the persisted config are present.
+     */
+    readonly id: string;
+    /**
+     * Mutates an isolated schema before parsing.
+     */
+    extendJsonSchema?(options: {
+        schema: JsonObject;
+    }): void;
+    /**
+     * `config` is decoded sync config. Everything else needed to parse it is supplied through `context`.
+     * Parse module-owned input into context.parsedConfig, including connectionConfig entries for this module.
+     * Core does not copy connection options from the input or normalize the parser's output here.
+     * For a PrecompiledSyncConfig, add this parser's ID to parsedConfig.plan.moduleData with a null value
+     * when the config requires this module. The plan's keys determine which parsers must be present on reload.
+     */
+    parse(options: {
+        config: unknown;
+        context: SyncConfigParserContext;
+    }): void;
+    /**
+     * Validate saved config fields without reparsing their original config or requiring config source locations.
+     */
+    validatePersisted?(options: {
+        config: SyncConfig;
+        context: PersistedSyncConfigParserContext;
+    }): void;
+}
+export declare function validateAdditionalSyncConfigParsers(parsers: readonly AdditionalSyncConfigParser[]): void;

package/dist/SyncConfigParserHooks.js

@@ -0,0 +1,11 @@
+export function validateAdditionalSyncConfigParsers(parsers) {
+    const ids = new Set();
+    for (const parser of parsers) {
+        if (!parser.id)
+            throw new Error('A sync config parser id must not be empty.');
+        if (ids.has(parser.id))
+            throw new Error(`A sync config parser is already registered with id '${parser.id}'.`);
+        ids.add(parser.id);
+    }
+}
+//# sourceMappingURL=SyncConfigParserHooks.js.map

package/dist/SyncConfigParserHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncConfigParserHooks.js","sourceRoot":"","sources":["../src/SyncConfigParserHooks.ts"],"names":[],"mappings":"AAyGA,MAAM,UAAU,mCAAmC,CAAC,OAA8C;IAChG,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC9E,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;QAC9G,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/compatibility.d.ts

@@ -17,7 +17,7 @@ export declare class TimeValuePrecision {
  * A historical issue of the PowerSync service that can only be changed in a backwards-incompatible manner.
  *
  * To avoid breaking existing users, fixes to those quirks are opt-in: Users either have to use `fixed_quirks` list when
- * defining sync rules or use a new feature such as sync streams where these issues are fixed by default.
+ * defining legacy Sync Rules or use a new feature such as Sync Streams where these issues are fixed by default.
  */
 export declare class CompatibilityOption {
     readonly name: string;
@@ -29,6 +29,7 @@ export declare class CompatibilityOption {
     static fixedJsonExtract: CompatibilityOption;
     static customTypes: CompatibilityOption;
     static sqliteExpressionEngine: CompatibilityOption;
+    static fixedBooleanInJson: CompatibilityOption;
     static byName: Record<string, CompatibilityOption>;
 }
 export interface CompatibilityContextOptions {

package/dist/compatibility.js

@@ -26,7 +26,7 @@ export class TimeValuePrecision {
  * A historical issue of the PowerSync service that can only be changed in a backwards-incompatible manner.
  *
  * To avoid breaking existing users, fixes to those quirks are opt-in: Users either have to use `fixed_quirks` list when
- * defining sync rules or use a new feature such as sync streams where these issues are fixed by default.
+ * defining legacy Sync Rules or use a new feature such as Sync Streams where these issues are fixed by default.
  */
 export class CompatibilityOption {
     name;
@@ -42,12 +42,14 @@ export class CompatibilityOption {
     static fixedJsonExtract = new CompatibilityOption('fixed_json_extract', "Old versions of the sync service used to treat `->> 'foo.bar'` as a two-element JSON path. With this compatibility option enabled, it follows modern SQLite and treats it as a single key. The `$.` prefix would be required to split on `.`.", CompatibilityEdition.SYNC_STREAMS);
     static customTypes = new CompatibilityOption('custom_postgres_types', 'Map custom Postgres types into appropriate structures instead of syncing the raw string.', CompatibilityEdition.SYNC_STREAMS);
     static sqliteExpressionEngine = new CompatibilityOption('unstable_sqlite_expression_engine', 'Experimental option to evaluate functions and operators in Sync Streams with SQLite instead of a JavaScript implementation.', null);
+    static fixedBooleanInJson = new CompatibilityOption('fixed_booleans_in_json', 'Consistently sync boolean values of a JSON object or array in source data as booleans (instead of integers 0/1).', null);
     static byName = Object.freeze({
         timestamps_iso8601: this.timestampsIso8601,
         versioned_bucket_ids: this.versionedBucketIds,
         fixed_json_extract: this.fixedJsonExtract,
         custom_postgres_types: this.customTypes,
-        unstable_sqlite_expression_engine: this.sqliteExpressionEngine
+        unstable_sqlite_expression_engine: this.sqliteExpressionEngine,
+        fixed_booleans_in_json: this.fixedBooleanInJson
     });
 }
 export class CompatibilityContext {

package/dist/compatibility.js.map

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

package/dist/compiler/bucket_resolver.d.ts

@@ -30,6 +30,7 @@ export declare class ParameterLookup implements Equatable {
     equals(other: unknown): boolean;
 }
 export declare class EvaluateTableValuedFunction implements Equatable {
+    #private;
     readonly tableValuedFunction: TableValuedResultSet;
     readonly outputs: RowExpression[];
     readonly filters: RowExpression[];

package/dist/compiler/bucket_resolver.js

@@ -1,4 +1,4 @@
-import { equalsIgnoringResultSetList, equalsIgnoringResultSetUnordered } from './compatibility.js';
+import { TableValuedFunctionEquality } from './compatibility.js';
 import { HashSet, StableHasher, unorderedEquality } from './equality.js';
 /**
  * Describes how to resolve a subscription to buckets.
@@ -17,7 +17,7 @@ export class StreamResolver {
         this.uniqueName = uniqueName;
     }
     buildInstantiationHash(hasher) {
-        equalsIgnoringResultSetUnordered.hash(hasher, this.requestFilters);
+        TableValuedFunctionEquality.empty.unorderedEquality.hash(hasher, this.requestFilters);
         StreamResolver.lookupStageEquality.hash(hasher, this.lookupStages);
         this.resolvedBucket.buildInstantiationHash(hasher);
     }
@@ -25,7 +25,7 @@ export class StreamResolver {
         if (other.options != this.options) {
             return false;
         }
-        if (!equalsIgnoringResultSetUnordered.equals(other.requestFilters, this.requestFilters)) {
+        if (!TableValuedFunctionEquality.empty.unorderedEquality.equals(other.requestFilters, this.requestFilters)) {
             return false;
         }
         if (!StreamResolver.lookupStageEquality.equals(other.lookupStages, this.lookupStages)) {
@@ -68,21 +68,30 @@ export class EvaluateTableValuedFunction {
     tableValuedFunction;
     outputs;
     filters;
+    #hashes;
     constructor(tableValuedFunction, outputs, filters) {
         this.tableValuedFunction = tableValuedFunction;
         this.outputs = outputs;
         this.filters = filters;
+        this.#hashes = TableValuedFunctionEquality.forSingleTableValuedFunction(tableValuedFunction);
     }
     buildHash(hasher) {
-        this.tableValuedFunction.buildBehaviorHashCode(hasher);
-        equalsIgnoringResultSetList.hash(hasher, this.outputs);
-        equalsIgnoringResultSetList.hash(hasher, this.filters);
+        this.tableValuedFunction.buildBehaviorHashCode(TableValuedFunctionEquality.empty, hasher);
+        this.#hashes.listEquality.hash(hasher, this.outputs);
+        this.#hashes.unorderedEquality.hash(hasher, this.filters);
     }
     equals(other) {
-        return (other instanceof EvaluateTableValuedFunction &&
-            other.tableValuedFunction.behavesIdenticalTo(this.tableValuedFunction) &&
-            equalsIgnoringResultSetList.equals(other.outputs, this.outputs) &&
-            equalsIgnoringResultSetList.equals(other.filters, this.filters));
+        if (!(other instanceof EvaluateTableValuedFunction) ||
+            !other.tableValuedFunction.behavesIdenticalTo(this.tableValuedFunction, TableValuedFunctionEquality.empty)) {
+            return false;
+        }
+        const symbolMap = new Map();
+        const symbol = Symbol();
+        symbolMap.set(this.tableValuedFunction, symbol);
+        symbolMap.set(other.tableValuedFunction, symbol);
+        const equality = TableValuedFunctionEquality.mergeForEquality(this.#hashes, other.#hashes, symbolMap);
+        return (equality.listEquality.equals(this.outputs, other.outputs) &&
+            equality.unorderedEquality.equals(this.filters, other.filters));
     }
 }
 export class ResolveBucket {
@@ -111,10 +120,11 @@ export class RequestParameterValue {
         this.expression = expression;
     }
     buildHash(hasher) {
-        this.expression.assumingSameResultSetEqualityHashCode(hasher);
+        this.expression.assumingSamePrimaryResultSetEqualityHashCode(TableValuedFunctionEquality.empty, hasher);
     }
     equals(other) {
-        return other instanceof RequestParameterValue && other.expression.equalsAssumingSameResultSet(this.expression);
+        return (other instanceof RequestParameterValue &&
+            this.expression.equalsAssumingSamePrimaryResultSet(other.expression, TableValuedFunctionEquality.empty));
     }
 }
 export class LookupResultParameterValue {

package/dist/compiler/bucket_resolver.js.map

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

package/dist/compiler/compatibility.d.ts

@@ -1,16 +1,45 @@
 import { Equality, StableHasher } from './equality.js';
+import { SourceResultSet, TableValuedResultSet } from './table.js';
 /**
- * Interface for structures that can be compared for equality in a way that ignores referenced result set.
+ * A semantic equality operator for syntactic structures.
  *
  * This is primarily used to compare expressions across streams. If we have two streams defined as
  * `SELECT * FROM users WHERE id = ...` , the `id` column would not be equal between those since it references a the
- * logical `users` table added to each individual statement. But if we are in a context where we know the physical table
- * is the same, this allows comparing expressions for equality.
+ * syntactical `users` table added to each individual statement. But if we are in a context where we know the resolved
+ * physical table is the same, this allows comparing expressions for equality.
+ *
+ * It is the responsibility of the caller to also check the primary result set (like `users` in this example) for
+ * equality before invoking these methods. Additionally, streams are allowed to join table-valued functions derived from
+ * the primary result set. Those must also be equal, which is why {@link TableValuedHashCodes} is used to generate
+ * stable hash codes for them and {@link TableValuedIdentities} guarantees that available table-valued functions have a
+ * 1:1 correspondence between compared structures.
  */
-export interface EqualsIgnoringResultSet {
-    equalsAssumingSameResultSet(other: EqualsIgnoringResultSet): boolean;
-    assumingSameResultSetEqualityHashCode(hasher: StableHasher): void;
+export interface EqualsIgnoringPrimaryResultSet {
+    equalsAssumingSamePrimaryResultSet(other: EqualsIgnoringPrimaryResultSet, tableValued: TableValuedFunctionEquality): boolean;
+    assumingSamePrimaryResultSetEqualityHashCode(tableValued: TableValuedFunctionEquality, hasher: StableHasher): void;
+}
+interface ReadOnlyMap<K, V> {
+    get(key: K): V | undefined;
+}
+export declare class TableValuedFunctionEquality implements Equality<EqualsIgnoringPrimaryResultSet> {
+    #private;
+    private constructor();
+    get listEquality(): Equality<Iterable<EqualsIgnoringPrimaryResultSet>>;
+    get unorderedEquality(): Equality<Iterable<EqualsIgnoringPrimaryResultSet>>;
+    equals(a: EqualsIgnoringPrimaryResultSet, b: EqualsIgnoringPrimaryResultSet): boolean;
+    resultSetEquals(a: SourceResultSet, b: SourceResultSet): boolean;
+    hashResultSet(hasher: StableHasher, resultSet: SourceResultSet): void;
+    hash(hasher: StableHasher, value: EqualsIgnoringPrimaryResultSet): void;
+    /**
+     * An equality operator for table-valued functions, suitable only for generating hash codes within a single structure
+     * owning table-valued functions.
+     *
+     * This can't be used to compare functions across streams or to test for equality.
+     */
+    static forHashCode(innerHashes: ReadOnlyMap<TableValuedResultSet, number>): TableValuedFunctionEquality;
+    static forSingleTableValuedFunction(resultSet: TableValuedResultSet): TableValuedFunctionEquality;
+    static forSingleOwner(innerHashes: ReadOnlyMap<TableValuedResultSet, number>, equality: ReadOnlyMap<TableValuedResultSet, unknown>): TableValuedFunctionEquality;
+    static mergeForEquality(localHashes: TableValuedFunctionEquality, otherHashes: TableValuedFunctionEquality, equality: ReadOnlyMap<TableValuedResultSet, symbol>): TableValuedFunctionEquality;
+    static readonly empty: TableValuedFunctionEquality;
 }
-export declare const equalsIgnoringResultSet: Equality<EqualsIgnoringResultSet>;
-export declare const equalsIgnoringResultSetList: Equality<Iterable<EqualsIgnoringResultSet>>;
-export declare const equalsIgnoringResultSetUnordered: Equality<Iterable<EqualsIgnoringResultSet>>;
+export {};

package/dist/compiler/compatibility.js

@@ -1,12 +1,82 @@
-import { listEquality } from './equality.js';
-export const equalsIgnoringResultSet = {
-    equals: function (a, b) {
-        return a.equalsAssumingSameResultSet(b);
-    },
-    hash: function (hasher, value) {
-        return value.assumingSameResultSetEqualityHashCode(hasher);
-    }
-};
-export const equalsIgnoringResultSetList = listEquality(equalsIgnoringResultSet);
-export const equalsIgnoringResultSetUnordered = listEquality(equalsIgnoringResultSet);
+import { listEquality, unorderedEquality } from './equality.js';
+import { PhysicalSourceResultSet } from './table.js';
+export class TableValuedFunctionEquality {
+    #hashes;
+    #identities;
+    #ordered;
+    #unordered;
+    constructor(hashes, identities) {
+        this.#hashes = hashes;
+        this.#identities = identities;
+    }
+    get listEquality() {
+        return (this.#ordered ??= listEquality(this));
+    }
+    get unorderedEquality() {
+        return (this.#unordered ??= unorderedEquality(this));
+    }
+    #lookupIdentity(resultSet) {
+        const symbol = this.#identities.get(resultSet);
+        if (symbol == null) {
+            throw new Error('Unknown table-valued result set for equals');
+        }
+        return symbol;
+    }
+    equals(a, b) {
+        return a.equalsAssumingSamePrimaryResultSet(b, this);
+    }
+    resultSetEquals(a, b) {
+        // We don't need to compare primary result sets, those are assumed to be equal.
+        if (a instanceof PhysicalSourceResultSet) {
+            return b instanceof PhysicalSourceResultSet;
+        }
+        else if (b instanceof PhysicalSourceResultSet) {
+            return a instanceof PhysicalSourceResultSet;
+        }
+        return this.#lookupIdentity(a) === this.#lookupIdentity(b);
+    }
+    hashResultSet(hasher, resultSet) {
+        // There's only one primary result set which we ignore by design.
+        if (resultSet instanceof PhysicalSourceResultSet)
+            return;
+        const hash = this.#hashes.get(resultSet);
+        if (hash == null) {
+            throw new Error('Hashing unknown table-valued result set');
+        }
+        hasher.addHash(hash);
+    }
+    hash(hasher, value) {
+        return value.assumingSamePrimaryResultSetEqualityHashCode(this, hasher);
+    }
+    /**
+     * An equality operator for table-valued functions, suitable only for generating hash codes within a single structure
+     * owning table-valued functions.
+     *
+     * This can't be used to compare functions across streams or to test for equality.
+     */
+    static forHashCode(innerHashes) {
+        return this.forSingleOwner(innerHashes, {
+            // Compare by identity within the single owner.
+            get: (tableValued) => tableValued
+        });
+    }
+    static forSingleTableValuedFunction(resultSet) {
+        const hashCodeMap = new Map();
+        // Hash codes are only used to ensure column references to different table-valued functions generate different
+        // codes. Since there's just one, it can be an arbitrary value.
+        hashCodeMap.set(resultSet, 0);
+        return this.forHashCode(hashCodeMap);
+    }
+    static forSingleOwner(innerHashes, equality) {
+        return new TableValuedFunctionEquality(innerHashes, equality);
+    }
+    static mergeForEquality(localHashes, otherHashes, equality) {
+        return new TableValuedFunctionEquality({
+            get(key) {
+                return localHashes.#hashes.get(key) ?? otherHashes.#hashes.get(key);
+            }
+        }, equality);
+    }
+    static empty = new TableValuedFunctionEquality(new Map(), new Map());
+}
 //# sourceMappingURL=compatibility.js.map

package/dist/compiler/compatibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"compatibility.js","sourceRoot":"","sources":["../../src/compiler/compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,YAAY,EAAgB,MAAM,eAAe,CAAC;AAerE,MAAM,CAAC,MAAM,uBAAuB,GAAsC;IACxE,MAAM,EAAE,UAAU,CAA0B,EAAE,CAA0B;QACtE,OAAO,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,EAAE,UAAU,MAAoB,EAAE,KAA8B;QAClE,OAAO,KAAK,CAAC,qCAAqC,CAAC,MAAM,CAAC,CAAC;IAC7D,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,YAAY,CAAC,uBAAuB,CAAC,CAAC;AACjF,MAAM,CAAC,MAAM,gCAAgC,GAAG,YAAY,CAAC,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"compatibility.js","sourceRoot":"","sources":["../../src/compiler/compatibility.ts"],"names":[],"mappings":"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"}

package/dist/compiler/compiler.d.ts

@@ -1,9 +1,11 @@
 import { NodeLocation, PGNode } from 'pgsql-ast-parser';
-import { StreamOptions, SyncPlan } from '../sync_plan/plan.js';
+import { SqlRuleError } from '../errors.js';
+import { CompiledEventDescriptor, StreamOptions, SyncPlan } from '../sync_plan/plan.js';
 import { SourceSchema } from '../types.js';
 import { StreamResolver } from './bucket_resolver.js';
-import { PointLookup, RowEvaluator } from './rows.js';
+import { EventRowEvaluator, PointLookup, RowEvaluator } from './rows.js';
 import { CommonTableExpression, PreparedSubquery } from './sqlite.js';
+import type { PhysicalSourceResultSet } from './table.js';
 export interface SyncStreamsCompilerOptions {
     /**
      * Used exclusively for linting against the given {@link schema}.
@@ -19,26 +21,33 @@ export interface SyncStreamsCompilerOptions {
      * streams across schema changes.
      */
     schema?: SourceSchema;
+    /**
+     * Whether event payload `WHERE` clauses are compiled and applied.
+     *
+     * This defaults to true. It is disabled for editions that cannot persist compiled event plans and when restoring
+     * event SQL that predates those plans, because the legacy evaluator parsed `WHERE` clauses but did not validate or
+     * evaluate them.
+     */
+    compileEventPayloadFilters?: boolean;
 }
 export interface ParseStreamOptions extends StreamOptions {
     warnOnDangerousParameter: boolean;
 }
 /**
- * State for compiling sync streams.
+ * State for compiling Sync Streams and replication events into a sync plan.
  *
- * The output of compiling all sync streams is a {@link SyncPlan}, a declarative description of the sync process that
- * can be serialized to bucket storage. The compiler stores a mutable intermediate representation that is essentially a
- * copy of the sync plan, except that we're using JavaScript classes with methods to compute hash codes and equality
- * relations. This allows the compiler to efficiently de-duplicate parameters and buckets.
+ * The compiler stores a mutable intermediate representation that is essentially a copy of the resulting
+ * {@link SyncPlan}. Stream compilation uses JavaScript classes with behavioral equality, while events use plain
+ * compiler records. Stream queries and event definitions remain separate within that model.
  *
- * Overall, the compilation process is as follows: Each data query for a stream is first parsed by
+ * The stream compilation process is as follows: Each data query for a stream is first parsed by
  * {@link StreamQueryParser} into a canonicalized intermediate representation (see that class for details).
  * Then, {@link QuerierGraphBuilder} analyzes a chain of `AND` expressions to identify parameters (as partition keys)
  * and their instantiation, as well as static filters that need to be added to reach row.
  */
 export declare class SyncStreamsCompiler {
     readonly options: SyncStreamsCompilerOptions;
-    readonly output: CompiledStreamQueries;
+    readonly output: SyncPlanCompilerModel;
     private readonly locations;
     constructor(options: SyncStreamsCompilerOptions);
     /**
@@ -53,14 +62,35 @@ export declare class SyncStreamsCompiler {
      */
     commonTableExpression(sql: string, errors: ParsingErrorListener): PreparedSubquery | null;
     /**
-     * Utility for compiling a sync stream.
+     * Utility for compiling a Sync Stream.
      *
      * @param options Name, priority and `auto_subscribe` state for the stream.
      */
     stream(options: ParseStreamOptions): IndividualSyncStreamCompiler;
+    /**
+     * Compiles the payload queries for a named replication event.
+     *
+     * Event queries intentionally support a smaller surface than stream queries: They must project and filter a single
+     * physical source table and cannot depend on request parameters, joins, subqueries or table-valued functions.
+     */
+    event(name: string): IndividualEventCompiler;
+    /**
+     * @returns A sync plan representing an immutable snapshot of the compiler output.
+     */
+    toSyncPlan(): SyncPlan;
 }
 /**
- * Utility for compiling a single sync stream.
+ * Compiles raw event definitions from legacy sync plans into the current plan representation.
+ *
+ * All definitions share one compiler to match normal sync-config compilation. Callers should reject fatal errors
+ * rather than carrying invalid legacy event evaluators into a {@link SyncPlan}.
+ */
+export declare function compileEventDefinitions(definitions: Readonly<Record<string, readonly string[]>>, options: SyncStreamsCompilerOptions): {
+    events: CompiledEventDescriptor[];
+    errors: SqlRuleError[];
+};
+/**
+ * Utility for compiling a single Sync Stream.
  */
 export interface IndividualSyncStreamCompiler {
     /**
@@ -80,10 +110,16 @@ export interface IndividualSyncStreamCompiler {
      */
     finish(): void;
 }
+export interface IndividualEventCompiler {
+    /**
+     * Validates and adds one payload query to this event.
+     */
+    addSourceQuery(sql: string, errors: ParsingErrorListener): void;
+}
 /**
  * Something reporting errors.
  *
- * While sync streams can be made up of multiple SQL statements from different YAML strings, we want to be able to
+ * While Sync Streams can be made up of multiple SQL statements from different YAML strings, we want to be able to
  * accurately describe the source of an error in YAML when we report it.
  *
  * So, every transformation that might need to report errors receives an instance of this interface which implicitly
@@ -106,8 +142,40 @@ export declare class CompiledStreamQueries {
     get pointLookups(): PointLookup[];
     canonicalizeEvaluator(evaluator: RowEvaluator): RowEvaluator;
     canonicalizePointLookup(lookup: PointLookup): PointLookup;
-    /**
-     * @returns A sync plan representing an immutable snapshot of this intermediate representation.
-     */
-    toSyncPlan(): SyncPlan;
+}
+/**
+ * Compiler model for one SQL query in a named event's `payloads` list.
+ *
+ * It binds that query to its single physical source table and contains one row evaluator for each normalized `OR`
+ * branch. Within each evaluator, filters determine whether a source row triggers the event, while projected columns
+ * determine the payload produced for a matching row.
+ *
+ * {@link sql} is retained so service-core can dual-write the legacy `eventDescriptors` field for older services during
+ * rolling upgrades. The executable plan uses the parsed source table and row evaluators instead.
+ */
+export interface CompiledEventSourceQueryModel {
+    sql: string;
+    sourceTable: PhysicalSourceResultSet;
+    variants: EventRowEvaluator[];
+}
+/**
+ * Compiler model for one named entry under `event_definitions`.
+ *
+ * {@link name} identifies the event exposed to handlers. {@link sourceQueries} represents its complete `payloads`
+ * list, which may define how rows from different source tables trigger that event and produce its payload.
+ */
+export interface CompiledEvent {
+    name: string;
+    sourceQueries: CompiledEventSourceQueryModel[];
+}
+/**
+ * Top-level compiler output used to assemble a complete sync plan.
+ *
+ * Streams and events are sibling sync-config concerns. Keeping their intermediate state separate prevents stream
+ * compilation abstractions from acquiring event-specific responsibilities just because both are persisted in one
+ * {@link SyncPlan}.
+ */
+export interface SyncPlanCompilerModel {
+    readonly streams: CompiledStreamQueries;
+    readonly events: CompiledEvent[];
 }