@powersync/service-sync-rules 0.0.0-dev-20260129132348 → 0.0.0-dev-20260202103935

package/dist/compiler/ir_to_sync_plan.js

@@ -0,0 +1,163 @@
+import * as resolver from './bucket_resolver.js';
+import { HashMap, StableHasher, unorderedEquality } from './equality.js';
+import { ColumnInRow } from './expression.js';
+import * as rows from './rows.js';
+import { MapSourceVisitor, visitExpr } from '../sync_plan/expression_visitor.js';
+export class CompilerModelToSyncPlan {
+    static evaluatorHash = unorderedEquality({
+        hash: (hasher, value) => value.buildBehaviorHashCode(hasher),
+        equals: (a, b) => a.behavesIdenticalTo(b)
+    });
+    mappedObjects = new Map();
+    buckets = [];
+    /**
+     * Mapping of row evaluators to buckets.
+     *
+     * One might expect one stream to result in one bucket, but that is not generally the case. First, a stream might
+     * define multiple buckets. For instance, `SELECT * FROM notes WHERE notes.is_public OR auth.parameter('admin')`
+     * requires two buckets since there are different ways a row in `notes` might be synced (we have one bucket with
+     * public notes and one bucket of all notes, and then decide which ones a given user has access to by inspecting the
+     * token).
+     *
+     * Further, a stream might have multiple evaluators but only a single bucket. A stream with queries
+     * `SELECT * FROM foo` and `SELECT * FROM bar` is an example for that, we want to merge `foo` and `bar` into the same
+     * bucket in this case. This is represented by a {@link resolver.StreamResolver} having multiple evaluators attached
+     * to it.
+     *
+     * Finally, we may even be able to re-use buckets between streams. This is not possible in many cases, but can be done
+     * if e.g. one stream is `SELECT * FROM profiles WHERE user = auth.user_id()` and another one is
+     * `SELECT * FROM profiles WHERE user IN (SELECT member FROM orgs WHERE id = auth.parameter('org'))`. Because the
+     * partitioning on `profiles` is the same in both cases, it doesn't matter how the buckets are instantiated.
+     */
+    evaluatorsToBuckets = new HashMap(CompilerModelToSyncPlan.evaluatorHash);
+    translateStatefulObject(source, map) {
+        const mapped = map();
+        this.mappedObjects.set(source, mapped);
+        return mapped;
+    }
+    translate(source) {
+        const queriersByStream = Object.groupBy(source.resolvers, (r) => r.options.name);
+        return {
+            dataSources: source.evaluators.map((e) => this.translateRowEvaluator(e)),
+            parameterIndexes: source.pointLookups.map((p, i) => this.translatePointLookup(p, i)),
+            // Note: data sources and parameter indexes must be translated first because we reference them in stream
+            // resolvers.
+            streams: Object.values(queriersByStream).map((resolvers) => {
+                return {
+                    stream: resolvers[0].options,
+                    queriers: resolvers.map((e) => this.translateStreamResolver(e))
+                };
+            }),
+            buckets: this.buckets
+        };
+    }
+    createBucketSource(evaluators, uniqueName) {
+        return this.evaluatorsToBuckets.putIfAbsent(evaluators, () => {
+            const hash = StableHasher.hashWith(CompilerModelToSyncPlan.evaluatorHash, evaluators);
+            const source = {
+                hashCode: hash,
+                sources: evaluators.map((e) => this.mappedObjects.get(e)),
+                uniqueName
+            };
+            this.buckets.push(source);
+            return source;
+        });
+    }
+    translatePartitionKey(value) {
+        return { expr: this.translateExpression(value.expression.expression) };
+    }
+    translateRowEvaluator(value) {
+        return this.translateStatefulObject(value, () => {
+            const hasher = new StableHasher();
+            value.buildBehaviorHashCode(hasher);
+            const mapped = {
+                sourceTable: value.tablePattern,
+                hashCode: hasher.buildHashCode(),
+                columns: value.columns.map((e) => {
+                    if (e instanceof rows.StarColumnSource) {
+                        return 'star';
+                    }
+                    else {
+                        return { expr: this.translateExpression(e.expression.expression), alias: e.alias ?? null };
+                    }
+                }),
+                outputTableName: value.outputName,
+                filters: value.filters.map((e) => this.translateExpression(e.expression)),
+                parameters: value.partitionBy.map((e) => this.translatePartitionKey(e))
+            };
+            return mapped;
+        });
+    }
+    translatePointLookup(value, index) {
+        return this.translateStatefulObject(value, () => {
+            const hasher = new StableHasher();
+            value.buildBehaviorHashCode(hasher);
+            return {
+                sourceTable: value.tablePattern,
+                defaultLookupScope: {
+                    // This just needs to be unique, and isn't visible to users (unlike bucket names). We might want to use a
+                    // more stable naming scheme in the future.
+                    lookupName: 'lookup',
+                    queryId: index.toString()
+                },
+                hashCode: hasher.buildHashCode(),
+                outputs: value.result.map((e) => this.translateExpression(e.expression)),
+                filters: value.filters.map((e) => this.translateExpression(e.expression)),
+                parameters: value.partitionBy.map((e) => this.translatePartitionKey(e))
+            };
+        });
+    }
+    translateExpression(expression) {
+        const mapper = new MapSourceVisitor((value) => {
+            if (value instanceof ColumnInRow) {
+                return { column: value.column };
+            }
+            else {
+                return { request: value.source };
+            }
+        });
+        return visitExpr(mapper, expression.node, null);
+    }
+    translateStreamResolver(value) {
+        return {
+            requestFilters: value.requestFilters.map((e) => this.translateExpression(e.expression)),
+            lookupStages: value.lookupStages.map((stage) => {
+                return stage.map((e) => this.translateExpandingLookup(e));
+            }),
+            bucket: this.createBucketSource([...value.resolvedBucket.evaluators], value.uniqueName),
+            sourceInstantiation: value.resolvedBucket.instantiation.map((e) => this.translateParameterValue(e))
+        };
+    }
+    translateExpandingLookup(value) {
+        return this.translateStatefulObject(value, () => {
+            if (value instanceof resolver.ParameterLookup) {
+                return {
+                    type: 'parameter',
+                    lookup: this.mappedObjects.get(value.lookup),
+                    instantiation: value.instantiation.map((e) => this.translateParameterValue(e))
+                };
+            }
+            else {
+                return {
+                    type: 'table_valued',
+                    functionName: value.tableValuedFunction.tableValuedFunctionName,
+                    functionInputs: value.tableValuedFunction.parameters.map((e) => this.translateExpression(e.expression)),
+                    outputs: value.outputs.map((e) => this.translateExpression(e.expression)),
+                    filters: value.filters.map((e) => this.translateExpression(e.expression))
+                };
+            }
+        });
+    }
+    translateParameterValue(value) {
+        if (value instanceof resolver.RequestParameterValue) {
+            return { type: 'request', expr: this.translateExpression(value.expression.expression) };
+        }
+        else if (value instanceof resolver.LookupResultParameterValue) {
+            return { type: 'lookup', resultIndex: value.resultIndex, lookup: this.mappedObjects.get(value.lookup) };
+        }
+        else {
+            return { type: 'intersection', values: value.inner.map((e) => this.translateParameterValue(e)) };
+        }
+    }
+}
+//# sourceMappingURL=ir_to_sync_plan.js.map

package/dist/compiler/ir_to_sync_plan.js.map

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

package/dist/compiler/parser.d.ts

@@ -0,0 +1,99 @@
+import { Statement } from 'pgsql-ast-parser';
+import { PhysicalSourceResultSet, SourceResultSet } from './table.js';
+import { ColumnSource } from './rows.js';
+import { NodeLocations } from './expression.js';
+import { Or } from './filter.js';
+import { PreparedSubquery } from './sqlite.js';
+import { SqlScope } from './scope.js';
+import { ParsingErrorListener, SyncStreamsCompiler } from './compiler.js';
+/**
+ * A parsed stream query in its canonical form.
+ *
+ * The canonical form of stream queries is as follows:
+ *
+ * ```SQL
+ * SELECT <expr>* FROM sourceTable a
+ *   JOIN table2 b
+ *   -- ... additional joins
+ * WHERE <expr>
+ * ```
+ *
+ * Expressions in the result set must all refer to columns in the {@link sourceTable}.
+ *
+ * Additionally, the where clause is in disjunctive normal form. Inner terms are either scalar expressions only
+ * depending on data from a single source result set, or match clauses.
+ *
+ * Subqueries are not allowed in the canonical form. Instead, they are lowered into joins. So e.g. the query:
+ *
+ * ```SQL
+ * SELECT * FROM users WHERE id IN (SELECT user FROM org WHERE id = auth.user_id())
+ * ```
+ *
+ * would get lowered to:
+ * ```SQL
+ * SELECT tmp0.* FROM users tmp0
+ *   JOIN org tmp1
+ * WHERE tmp0.id = tmp1.user AND tmp1.id = (:auth_token) ->> '$.sub';
+ * ```
+ *
+ * Unlike shown here, this lowering doesn't generate aliases that would have to be applied to expressions though.
+ * References in expressions would get resolved earlier, and they continue being valid after the transformation.
+ */
+export interface ParsedStreamQuery {
+    resultColumns: ColumnSource[];
+    sourceTable: PhysicalSourceResultSet;
+    joined: SourceResultSet[];
+    /**
+     * All filters, in disjunctive normal form (an OR of ANDs).
+     */
+    where: Or;
+}
+export interface StreamQueryParserOptions {
+    compiler: SyncStreamsCompiler;
+    originalText: string;
+    errors: ParsingErrorListener;
+    parentScope: SqlScope;
+    locations: NodeLocations;
+}
+export declare class StreamQueryParser {
+    readonly errors: ParsingErrorListener;
+    private readonly compiler;
+    readonly originalText: string;
+    private readonly statementScope;
+    private readonly resultSets;
+    private readonly subqueryResultSets;
+    private readonly resultColumns;
+    private where;
+    /** The result set for which rows are synced. Set when analyzing result columns. */
+    private primaryResultSet?;
+    private syntheticSubqueryCounter;
+    private nodeLocations;
+    private exprParser;
+    constructor(options: StreamQueryParserOptions);
+    parse(stmt: Statement): ParsedStreamQuery | null;
+    parseAsSubquery(stmt: Statement, columnNames?: string[]): PreparedSubquery | null;
+    private nestedParser;
+    /**
+     * Process the AST of a statement, returning whether it's close enough to a valid select statement to be supported for
+     * sync streams (allowing us to process an invalid statement further to perhaps collect more errors).
+     */
+    private processAst;
+    private addAndTermToWhereClause;
+    private addSubquery;
+    private processFrom;
+    private resolveTableValued;
+    private inferColumnName;
+    private processResultColumns;
+    private parseExpression;
+    private resolveTableName;
+    private resolveSoure;
+    private warnUnsupported;
+    private compileFilterClause;
+    private mapBaseExpression;
+    /**
+     * Emit diagnostics if the expression references data from more than one table, otherwise returns it as a
+     * single-dependency expression.
+     */
+    private mustBeSingleDependency;
+    private extractBooleanOperators;
+}