@powersync/service-sync-rules 0.29.10 → 0.31.0

package/dist/sync_plan/evaluator/bucket_source.js

@@ -0,0 +1,145 @@
+import { BucketSourceType } from '../../BucketSource.js';
+import { mapExternalDataToInstantiation } from '../engine/scalar_expression_engine.js';
+import { parametersForRequest, RequestParameterEvaluators } from './parameter_evaluator.js';
+import { buildBucketName, JSONBucketNameSerialize } from '../../utils.js';
+export class StreamBucketSource {
+    stream;
+    input;
+    dataSources = [];
+    parameterIndexLookupCreators = [];
+    constructor(stream, input) {
+        this.stream = stream;
+        this.input = input;
+        for (const querier of stream.queriers) {
+            const mappedSource = input.preparedBuckets.get(querier.bucket);
+            this.dataSources.push(mappedSource);
+        }
+    }
+    get name() {
+        return this.stream.stream.name;
+    }
+    get subscribedToByDefault() {
+        return this.stream.stream.isSubscribedByDefault;
+    }
+    get type() {
+        return BucketSourceType.SYNC_STREAM;
+    }
+    debugRepresentation() {
+        // TODO: Implement debugRepresentation for compiled sync streams
+        return `stream ${this.stream.stream.name}`;
+    }
+    hydrate(params) {
+        const queriers = this.stream.queriers.map((q) => new PreparedQuerier(this.stream.stream, q, this.input));
+        return {
+            definition: this,
+            pushBucketParameterQueriers: (result, options) => {
+                const subscriptions = options.streams[this.name] ?? [];
+                if (!this.subscribedToByDefault && !subscriptions.length) {
+                    // The client is not subscribing to this stream, so don't query buckets related to it.
+                    return;
+                }
+                let hasExplicitDefaultSubscription = false;
+                for (const subscription of subscriptions) {
+                    let subscriptionParams = options.globalParameters;
+                    if (subscription.parameters != null) {
+                        subscriptionParams = subscriptionParams.withAddedStreamParameters(subscription.parameters);
+                    }
+                    else {
+                        hasExplicitDefaultSubscription = true;
+                    }
+                    for (const querier of queriers) {
+                        querier.querierForSubscription(params, result, subscriptionParams, subscription);
+                    }
+                }
+                // If the stream is subscribed to by default and there is no explicit subscription that would match the default
+                // subscription, also include the default querier.
+                if (this.subscribedToByDefault && !hasExplicitDefaultSubscription) {
+                    for (const querier of queriers) {
+                        querier.querierForSubscription(params, result, options.globalParameters, null);
+                    }
+                }
+            }
+        };
+    }
+}
+class PreparedQuerier {
+    stream;
+    matchesParameters;
+    lookupStages;
+    dataSource;
+    constructor(stream, querier, options) {
+        this.stream = stream;
+        this.dataSource = options.preparedBuckets.get(querier.bucket);
+        this.matchesParameters = PreparedQuerier.prepareFilters(options.engine, querier.requestFilters);
+        this.lookupStages = RequestParameterEvaluators.prepare(querier.lookupStages, querier.sourceInstantiation, options);
+    }
+    querierForSubscription(hydration, result, params, subscription) {
+        const reason = subscription != null ? { subscription: subscription.opaque_id } : 'default';
+        try {
+            if (!this.matchesParameters(params)) {
+                return;
+            }
+            const subscriptionEvaluators = this.lookupStages.clone();
+            subscriptionEvaluators.partiallyInstantiate({ request: params });
+            if (subscriptionEvaluators.isDefinitelyUninstantiable()) {
+                return;
+            }
+            const bucketScope = hydration.hydrationState.getBucketSourceScope(this.dataSource);
+            const parametersToBucket = (instantiation) => {
+                return {
+                    definition: this.stream.name,
+                    inclusion_reasons: [reason],
+                    bucket: buildBucketName(bucketScope, JSONBucketNameSerialize.stringify(instantiation)),
+                    priority: this.stream.priority
+                };
+            };
+            // Do we need parameter lookups to resolve parameters?
+            const staticInstantiation = subscriptionEvaluators.extractFullInstantiation();
+            if (staticInstantiation) {
+                // We don't! Return static querier.
+                result.queriers.push({
+                    staticBuckets: staticInstantiation.map(parametersToBucket),
+                    hasDynamicBuckets: false,
+                    async queryDynamicBucketDescriptions() {
+                        return [];
+                    }
+                });
+            }
+            else {
+                result.queriers.push({
+                    staticBuckets: [],
+                    hasDynamicBuckets: true,
+                    async queryDynamicBucketDescriptions(source) {
+                        const evaluators = subscriptionEvaluators.clone();
+                        const instantiation = await evaluators.instantiate({
+                            hydrationState: hydration.hydrationState,
+                            source,
+                            request: params
+                        });
+                        return [...instantiation].map(parametersToBucket);
+                    }
+                });
+            }
+        }
+        catch (e) {
+            result.errors.push({
+                descriptor: this.stream.name,
+                message: `Error evaluating bucket ids: ${e.message}`,
+                subscription: subscription ?? undefined
+            });
+        }
+    }
+    static prepareFilters(engine, requestFilters) {
+        const mapExpressions = mapExternalDataToInstantiation();
+        const evaluator = engine.prepareEvaluator({
+            outputs: [],
+            filters: requestFilters.map((f) => mapExpressions.transform(f))
+        });
+        const instantiation = mapExpressions.instantiation;
+        return (parameters) => {
+            // We've added request filters as filters to prepareEvaluator, so if we get a row then the subscription matches.
+            return evaluator.evaluate(parametersForRequest(parameters, instantiation)).length != 0;
+        };
+    }
+}
+//# sourceMappingURL=bucket_source.js.map

package/dist/sync_plan/evaluator/bucket_source.js.map

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

package/dist/sync_plan/evaluator/index.d.ts

@@ -0,0 +1,17 @@
+import * as plan from '../plan.js';
+import { ScalarExpressionEngine } from '../engine/scalar_expression_engine.js';
+import { SyncConfig } from '../../SyncConfig.js';
+export interface StreamEvaluationContext {
+    defaultSchema: string;
+    engine: ScalarExpressionEngine;
+    /**
+     * Source contents that were used to compile the sync plan.
+     *
+     * This is not used to evaluate rows, but required for all sync config instances.
+     */
+    sourceText: string;
+}
+export declare class PrecompiledSyncConfig extends SyncConfig {
+    readonly plan: plan.SyncPlan;
+    constructor(plan: plan.SyncPlan, context: StreamEvaluationContext);
+}

package/dist/sync_plan/evaluator/index.js

@@ -0,0 +1,32 @@
+import { PreparedStreamBucketDataSource } from './bucket_data_source.js';
+import { PreparedParameterIndexLookupCreator } from './parameter_index_lookup_creator.js';
+import { StreamBucketSource } from './bucket_source.js';
+import { SyncConfig } from '../../SyncConfig.js';
+export class PrecompiledSyncConfig extends SyncConfig {
+    plan;
+    constructor(plan, context) {
+        super(context.sourceText);
+        this.plan = plan;
+        const preparedBuckets = new Map();
+        const preparedLookups = new Map();
+        for (const bucket of plan.buckets) {
+            const prepared = new PreparedStreamBucketDataSource(bucket, context);
+            preparedBuckets.set(bucket, prepared);
+            this.bucketDataSources.push(prepared);
+        }
+        for (const parameter of plan.parameterIndexes) {
+            const prepared = new PreparedParameterIndexLookupCreator(parameter, context);
+            preparedLookups.set(parameter, prepared);
+            this.bucketParameterLookupSources.push(prepared);
+        }
+        const streamInput = {
+            ...context,
+            preparedBuckets,
+            preparedLookups
+        };
+        for (const stream of plan.streams) {
+            this.bucketSources.push(new StreamBucketSource(stream, streamInput));
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/sync_plan/evaluator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sync_plan/evaluator/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,mCAAmC,EAAE,MAAM,qCAAqC,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAe,MAAM,oBAAoB,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAcjD,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IAExC;IADX,YACW,IAAmB,EAC5B,OAAgC;QAEhC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAHjB,SAAI,GAAJ,IAAI,CAAe;QAK5B,MAAM,eAAe,GAAG,IAAI,GAAG,EAA+D,CAAC;QAC/F,MAAM,eAAe,GAAG,IAAI,GAAG,EAA+E,CAAC;QAE/G,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,IAAI,8BAA8B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACrE,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACtC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,IAAI,mCAAmC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC7E,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACzC,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,WAAW,GAAgB;YAC/B,GAAG,OAAO;YACV,eAAe;YACf,eAAe;SAChB,CAAC;QACF,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;CACF"}

package/dist/sync_plan/evaluator/parameter_evaluator.d.ts

@@ -0,0 +1,138 @@
+import { ParameterLookupSource } from '../../BucketParameterQuerier.js';
+import { ParameterIndexLookupCreator } from '../../BucketSource.js';
+import { HydrationState } from '../../HydrationState.js';
+import { RequestParameters, SqliteParameterValue, SqliteValue } from '../../types.js';
+import * as plan from '../plan.js';
+import { StreamInput } from './bucket_source.js';
+/**
+ * Finds bucket parameters for a given request or subscription.
+ *
+ * In sync streams, queriers are represented as a DAG structure describing how to get from connection data to bucket
+ * parameters.
+ *
+ * As an example, consider the following stream:
+ *
+ * ```
+ * SELECT projects.* FROM projects
+ *  INNER JOIN orgs ON orgs.id = projects.org_id
+ * WHERE orgs.name = auth.parameter('org')
+ * ```
+ *
+ * This would partition data into a bucket with a single parameter (grouping by `projects.org_id`). It would also
+ * prepare a lookup from `orgs.name` to `orgs.id`.
+ *
+ * The querier for this would have:
+ *
+ *  1. A single lookup stage with a single {@link plan.ParameterLookup}. That lookup would have an instantiation
+ *     reflecting `auth.parameter('org')` as a `request` {@link plan.ParameterValue}.
+ *  2. A single {@link plan.StreamQuerier.sourceInstantiation}, a `lookup` {@link plan.ParameterValue} referencing the
+ *     lookup from step 1.
+ *
+ * On this prepared evaluator, lookup stages and parameter values are tracked as {@link PreparedExpandingLookup}s and
+ * {@link PreparedParameterValue}s, respectively. These correspond to their definitions on sync plans, except that:
+ *
+ *   1. Instead of being a description of the parameter, they're a JavaScript function that can be invoked to compute
+ *      parameters.
+ *   2. After being called once, we can replace them with a cached value. This enables a partial instantiation, and
+ *      avoids recomputing everything whenever a parameter lookup changes. In the example stream, we would run and cache
+ *      the outputs of `auth.parameter('org')` for a given connection. This sub-expression would not get re-evaluated
+ *      when the `org-name` -> `org.id` lookup changes.
+ *
+ * For queriers that don't use parameter lookups, e.g. for streams like `SELECT * FROM users WHERE id = auth.user_id()`,
+ * the partial instantiation based on connection data happens to be a complete instantiation. We use this when building
+ * queriers by indicating that no lookups will be used.
+ */
+export declare class RequestParameterEvaluators {
+    /**
+     * Pending lookup stages, or their cached outputs.
+     */
+    readonly lookupStages: PreparedExpandingLookup[][];
+    /**
+     * Pending parameter values, or their cached outputs.
+     */
+    readonly parameterValues: PreparedParameterValue[];
+    private constructor();
+    /**
+     * Returns a copy of this instance.
+     *
+     * Since resolved values are replaced with their instantiation, we need to use closed evaluators before evaluating
+     * them on inputs that might change (like parameter lookups).
+     *
+     * Static data (like connection parameters) can be resolved sooner, and cloning that partially-instantiated evaluator
+     * graph essentially forks it. This allows us to cache connection parameters for the lifetime of the connection
+     * instead of re-evaluating them on every parameter lookup change.
+     */
+    clone(): RequestParameterEvaluators;
+    /**
+     * Evaluates those lookups and parameter values that be evaluated without looking up parameter indexes.
+     *
+     * This is also used to determine whether a querier is static - if the partial instantiation depending on request data
+     * fully resolves the stream, we don't need to lookup any parameters.
+     */
+    partiallyInstantiate(input: PartialInstantiationInput): void;
+    /**
+     * Resolves and caches all lookup stages and parameter values.
+     *
+     * Because this needs to lookup parameter indexes, it is asynchronous.
+     */
+    instantiate(input: InstantiationInput): Promise<Generator<SqliteParameterValue[]>>;
+    /**
+     * Whether these evaluators are known to not result in any buckets, for instance because parameters are instanted to
+     * `NULL` values that aren't equal to anything.
+     *
+     * This is fairly efficient to compute and can be used to short-circuit further evaluation.
+     */
+    isDefinitelyUninstantiable(): boolean;
+    extractFullInstantiation(): SqliteParameterValue[][] | undefined;
+    /**
+     * Prepares evaluators for a description of parameter values obtained from a compiled querier in the sync plan.
+     *
+     * @param lookupStages The {@link plan.StreamQuerier.lookupStages} of the querier to compile.
+     * @param values The {@link plan.StreamQuerier.sourceInstantiation} of the querier to compile.
+     * @param input Access to bucket and parameter sources generated for buckets and parameter lookups referenced by the
+     * querier.
+     */
+    static prepare(lookupStages: plan.ExpandingLookup[][], values: plan.ParameterValue[], input: StreamInput): RequestParameterEvaluators;
+}
+export type PreparedExpandingLookup = {
+    type: 'parameter';
+    lookup: ParameterIndexLookupCreator;
+    instantiation: PreparedParameterValue[];
+} | {
+    type: 'table_valued';
+    read(request: RequestParameters): SqliteParameterValue[][];
+} | {
+    type: 'cached';
+    values: SqliteParameterValue[][];
+};
+/**
+ * A {@link plan.ParameterValue} that can be evaluated against request parameters.
+ *
+ * Additionally, this includes the `cached` variant which allows partially instantiating parameters.
+ */
+export type PreparedParameterValue = {
+    type: 'request';
+    read(request: RequestParameters): SqliteValue;
+} | {
+    type: 'lookup';
+    lookup: {
+        stage: number;
+        index: number;
+    };
+    resultIndex: number;
+} | {
+    type: 'intersection';
+    values: PreparedParameterValue[];
+} | {
+    type: 'cached';
+    values: SqliteParameterValue[];
+};
+export interface PartialInstantiationInput {
+    request: RequestParameters;
+}
+export interface InstantiationInput extends PartialInstantiationInput {
+    hydrationState: HydrationState;
+    source: ParameterLookupSource;
+}
+export declare function isValidParameterValueRow(row: SqliteValue[]): row is SqliteParameterValue[];
+export declare function parametersForRequest(parameters: RequestParameters, values: plan.SqlParameterValue[]): string[];