@powersync/service-sync-rules 0.27.0 → 0.29.0

package/dist/streams/from_sql.js

@@ -0,0 +1,375 @@
+import { SqlRuleError } from '../errors.js';
+import { isSelectStatement } from '../utils.js';
+import { andFilters, checkUnsupportedFeatures, isClauseError, isParameterMatchClause, isParameterValueClause, isRowValueClause, isStaticValueClause, orFilters } from '../sql_support.js';
+import { TablePattern } from '../TablePattern.js';
+import { TableQuerySchema } from '../TableQuerySchema.js';
+import { SqlTools } from '../sql_filters.js';
+import { BaseSqlDataQuery } from '../BaseSqlDataQuery.js';
+import { ExpressionType } from '../ExpressionType.js';
+import { SyncStream } from './stream.js';
+import { And, CompareRowValueWithStreamParameter, EvaluateSimpleCondition, ExistsOperator, InOperator, Not, Or, OverlapOperator, Subquery } from './filter.js';
+import { parse } from 'pgsql-ast-parser';
+import { STREAM_FUNCTIONS } from './functions.js';
+import { CompatibilityEdition } from '../compatibility.js';
+export function syncStreamFromSql(descriptorName, sql, options) {
+    const compiler = new SyncStreamCompiler(descriptorName, sql, options);
+    return [compiler.compile(), compiler.errors];
+}
+class SyncStreamCompiler {
+    descriptorName;
+    sql;
+    options;
+    errors;
+    constructor(descriptorName, sql, options) {
+        this.descriptorName = descriptorName;
+        this.sql = sql;
+        this.options = options;
+        this.errors = [];
+    }
+    compile() {
+        if (this.options.compatibility.edition < CompatibilityEdition.SYNC_STREAMS) {
+            throw new SqlRuleError('Sync streams require edition 2 or later. Try adding a `config: {edition: 2} block to the end of the file.`', this.sql);
+        }
+        const [stmt, ...illegalRest] = parse(this.sql, { locationTracking: true });
+        // TODO: Share more of this code with SqlDataQuery
+        if (illegalRest.length > 0) {
+            throw new SqlRuleError('Only a single SELECT statement is supported', this.sql, illegalRest[0]?._location);
+        }
+        const { query, tableRef, alias, querySchema, sourceTable } = this.checkValidSelectStatement(stmt);
+        const tools = new SqlTools({
+            table: alias,
+            parameterTables: [],
+            valueTables: [alias],
+            sql: this.sql,
+            schema: querySchema,
+            parameterFunctions: STREAM_FUNCTIONS,
+            compatibilityContext: this.options.compatibility,
+            supportsParameterExpressions: true,
+            supportsExpandingParameters: true // needed for table.column IN (subscription.parameters() -> ...)
+        });
+        tools.checkSpecificNameCase(tableRef);
+        let filter = this.whereClauseToFilters(tools, query.where);
+        filter = filter.toDisjunctiveNormalForm(tools);
+        const stream = new SyncStream(this.descriptorName, new BaseSqlDataQuery(this.compileDataQuery(tools, query, alias, sourceTable)));
+        stream.subscribedToByDefault = this.options.auto_subscribe ?? false;
+        if (filter.isValid(tools)) {
+            stream.variants = filter.compileVariants(this.descriptorName);
+        }
+        this.errors.push(...tools.errors);
+        return stream;
+    }
+    compileDataQuery(tools, query, alias, sourceTable) {
+        let hasId = false;
+        let hasWildcard = false;
+        let extractors = [];
+        const querySchema = tools.schema;
+        for (let column of query.columns ?? []) {
+            const name = tools.getOutputName(column);
+            if (name != '*') {
+                const clause = tools.compileRowValueExtractor(column.expr);
+                if (isClauseError(clause)) {
+                    // Error logged already
+                    continue;
+                }
+                extractors.push({
+                    extract: (tables, output) => {
+                        output[name] = clause.evaluate(tables);
+                    },
+                    getTypes(schema, into) {
+                        const def = clause.getColumnDefinition(schema);
+                        into[name] = { name, type: def?.type ?? ExpressionType.NONE, originalType: def?.originalType };
+                    }
+                });
+            }
+            else {
+                extractors.push({
+                    extract: (tables, output) => {
+                        const row = tables[alias];
+                        for (let key in row) {
+                            if (key.startsWith('_')) {
+                                continue;
+                            }
+                            output[key] ??= row[key];
+                        }
+                    },
+                    getTypes(schema, into) {
+                        for (let column of schema.getColumns(alias)) {
+                            into[column.name] ??= column;
+                        }
+                    }
+                });
+            }
+            if (name == 'id') {
+                hasId = true;
+            }
+            else if (name == '*') {
+                hasWildcard = true;
+                if (querySchema == null) {
+                    // Not performing schema-based validation - assume there is an id
+                    hasId = true;
+                }
+                else {
+                    const idType = querySchema.getColumn(alias, 'id')?.type ?? ExpressionType.NONE;
+                    if (!idType.isNone()) {
+                        hasId = true;
+                    }
+                }
+            }
+        }
+        if (!hasId) {
+            const error = new SqlRuleError(`Query must return an "id" column`, this.sql, query.columns?.[0]._location);
+            if (hasWildcard) {
+                // Schema-based validations are always warnings
+                error.type = 'warning';
+            }
+            tools.errors.push(error);
+        }
+        return {
+            sourceTable,
+            table: alias,
+            sql: this.sql,
+            columns: query.columns ?? [],
+            descriptorName: this.descriptorName,
+            tools,
+            extractors,
+            // Streams don't have traditional parameters, and parameters aren't used in the rest of the stream implementation.
+            // Instead, we represent parameters as an array in stream variants.
+            bucketParameters: []
+        };
+    }
+    checkUnsupportedFeatures(stmt) {
+        this.errors.push(...checkUnsupportedFeatures(this.sql, stmt));
+    }
+    whereClauseToFilters(tools, clause) {
+        // We need to handle some functions specially here:
+        //   1. IN subqueries are not allowed in regular data queries, so we handle them here instead of relying on SqlTools
+        //   2. Since IN operators can be composed with other operators using AND and OR, we need to handle those operators
+        //      as well.
+        // Apart from that we can rely on compileClause
+        if (clause != null) {
+            if (clause.type == 'binary') {
+                let operator, scalarCombinator;
+                if (clause.op == 'AND') {
+                    operator = And;
+                    scalarCombinator = andFilters;
+                }
+                else if (clause.op == 'OR') {
+                    operator = Or;
+                    scalarCombinator = orFilters;
+                }
+                else if (clause.op == 'IN' || clause.op == 'NOT IN') {
+                    const filter = this.compileInOperator(tools, clause);
+                    return clause.op == 'NOT IN' ? new Not(clause._location ?? null, filter) : filter;
+                }
+                else if (clause.op == '&&') {
+                    return this.compileOverlapOperator(tools, clause);
+                }
+                // Try to combine AND and OR operators on a scalar level first, without introducing more filters.
+                if (operator && scalarCombinator) {
+                    const left = this.whereClauseToFilters(tools, clause.left);
+                    const right = this.whereClauseToFilters(tools, clause.right);
+                    if (left instanceof EvaluateSimpleCondition && right instanceof EvaluateSimpleCondition) {
+                        let directCombination;
+                        try {
+                            directCombination = scalarCombinator(left.expression, right.expression);
+                        }
+                        catch (e) {
+                            // Left and right might be a combination of row and parameter values that can't be combined like this. Ok,
+                            // we can represent thas as separate filter instances.
+                        }
+                        if (directCombination && isScalarExpression(directCombination)) {
+                            return new EvaluateSimpleCondition(clause._location ?? null, directCombination);
+                        }
+                    }
+                    return new operator(clause._location ?? null, left, right);
+                }
+            }
+            else if (clause.type == 'unary') {
+                if (clause.op == 'NOT') {
+                    const inner = this.whereClauseToFilters(tools, clause.operand);
+                    if (inner instanceof EvaluateSimpleCondition) {
+                        // We can just negate that directly.
+                        return inner.negate(tools);
+                    }
+                    else {
+                        return new Not(clause._location ?? null, inner);
+                    }
+                }
+            }
+        }
+        const regularClause = tools.compileClause(clause);
+        return compiledClauseToFilter(tools, clause?._location ?? null, regularClause);
+    }
+    compileInOperator(tools, clause) {
+        // There are different kinds of `IN` operators we support in stream definitions:
+        //
+        //   1. Left row clause, right subquery: `WHERE issue_in IN (SELECT id FROM issue WHERE owner_id = request.user())`
+        //   2. Left parameter clause, right subquery: `WHERE request.user_id() IN (SELECT * FROM user_id FROM users WHERE is_admin)`.
+        //   3. Left parameter clause, right row data: `WHERE request.user() IN comments.tagged_users`.
+        //   4. Left row clause, right parameter data: `WHERE id IN subscription_parameters.ids`.
+        //   5. Left and right both row clauses, both parameter clauses, or mix or static and row/parameter clauses.
+        const left = tools.compileClause(clause.left);
+        const location = clause._location ?? null;
+        if (isClauseError(left)) {
+            return recoverErrorClause(tools);
+        }
+        if (clause.right.type == 'select') {
+            if (!isScalarExpression(left)) {
+                if (!isClauseError(left)) {
+                    tools.error('This may contain values derived from the source row to sync or a value derived from stream parameters, but never both.', clause.left);
+                }
+                return recoverErrorClause(tools);
+            }
+            const subqueryResult = this.compileSubquery(clause.right);
+            if (!subqueryResult) {
+                return recoverErrorClause(tools);
+            }
+            const [subquery, subqueryTools] = subqueryResult;
+            if (isStaticValueClause(left)) {
+                tools.error('For IN subqueries, the left operand must either depend on the row to sync or stream parameters.', clause.left);
+                return recoverErrorClause(tools);
+            }
+            if (isParameterValueClause(left)) {
+                // Case 2: We can't implement this as an actual IN operator because we need to use exact parameter lookups (so
+                // we can't, for instance, resolve `SELECT * FROM users WHERE is_admin` via parameter data sets). Since the
+                // left clause doesn't depend on row data however, we can push it down into the subquery where it would be
+                // introduced as a parameter: `EXISTS (SELECT _ FROM users WHERE is_admin AND user_id = request.user_id())`.
+                const additionalClause = subqueryTools.parameterMatchClause(subquery.column, left);
+                subquery.addFilter(compiledClauseToFilter(subqueryTools, null, additionalClause));
+                return new ExistsOperator(location, subquery);
+            }
+            else {
+                // Case 1
+                return new InOperator(location, left, subquery);
+            }
+        }
+        const right = tools.compileClause(clause.right);
+        // For cases 3-5, we can actually use SqlTools.compileClause. Case 3 and 4 are handled specially in there and return
+        // a ParameterMatchClause, which we can translate via CompareRowValueWithStreamParameter. Case 5 is either a row-value
+        // or a parameter-value clause which we can wrap in EvaluateSimpleCondition.
+        const combined = tools.compileInClause(clause.left, left, clause.right, right);
+        return compiledClauseToFilter(tools, location, combined);
+    }
+    compileOverlapOperator(tools, clause) {
+        const left = tools.compileClause(clause.left);
+        const location = clause._location ?? null;
+        if (isClauseError(left)) {
+            return recoverErrorClause(tools);
+        }
+        if (clause.right.type == 'select') {
+            if (!isRowValueClause(left)) {
+                if (!isClauseError(left)) {
+                    tools.error('The left-hand side of an && operator must be derived from the row to sync..', clause.left);
+                }
+                return recoverErrorClause(tools);
+            }
+            const subqueryResult = this.compileSubquery(clause.right);
+            if (!subqueryResult) {
+                return recoverErrorClause(tools);
+            }
+            const [subquery] = subqueryResult;
+            return new OverlapOperator(location, left, subquery);
+        }
+        const right = tools.compileClause(clause.right);
+        // For cases 3-5, we can actually uses SqlTools.compileClause. Case 3 and 4 are handled specially in there and return
+        // a ParameterMatchClause, which we can translate via CompareRowValueWithStreamParameter. Case 5 is either a row-value
+        // or a parameter-value clause which we can wrap in EvaluateSimpleCondition.
+        const combined = tools.compileOverlapClause(clause.left, left, clause.right, right);
+        return compiledClauseToFilter(tools, location, combined);
+    }
+    compileSubquery(stmt) {
+        // A subquery is similar to a data query in legacy sync rules. Importantly, despite being an expression, subqueries
+        // can't reference columns from the outer query! The syntax is always `SELECT <single column> FROM <table> WHERE
+        // <compiled clause>`.
+        let validated;
+        try {
+            validated = this.checkValidSelectStatement(stmt);
+        }
+        catch (e) {
+            if (e instanceof SqlRuleError) {
+                this.errors.push(e);
+            }
+            return undefined;
+        }
+        const { query, alias, querySchema, tableRef, sourceTable } = validated;
+        // Create a new tools instance for this - the subquery does not have access to the outer one.
+        const tools = new SqlTools({
+            table: alias,
+            parameterTables: [],
+            valueTables: [alias],
+            sql: this.sql,
+            schema: querySchema,
+            supportsParameterExpressions: true,
+            compatibilityContext: this.options.compatibility,
+            parameterFunctions: STREAM_FUNCTIONS
+        });
+        tools.checkSpecificNameCase(tableRef);
+        if (query.columns?.length != 1) {
+            tools.error('This subquery must return exactly one column', query);
+        }
+        const column = tools.compileRowValueExtractor(query.columns?.[0]?.expr);
+        if (isClauseError(column)) {
+            return;
+        }
+        const where = tools.compileClause(query.where);
+        this.errors.push(...tools.errors);
+        return [new Subquery(sourceTable, column, compiledClauseToFilter(tools, query.where?._location, where)), tools];
+    }
+    checkValidSelectStatement(stmt) {
+        if (!isSelectStatement(stmt)) {
+            throw new SqlRuleError('Only SELECT statements are supported', this.sql, stmt._location);
+        }
+        if (stmt.from == null || stmt.from.length != 1 || stmt.from[0].type != 'table') {
+            throw new SqlRuleError('Must SELECT from a single table', this.sql, stmt);
+        }
+        this.checkUnsupportedFeatures(stmt);
+        const tableRef = stmt.from?.[0].name;
+        if (tableRef?.name == null) {
+            throw new SqlRuleError('Must SELECT from a single table', this.sql, stmt.from?.[0]._location);
+        }
+        const alias = tableRef.alias ?? tableRef.name;
+        const sourceTable = new TablePattern(tableRef.schema ?? this.options.defaultSchema, tableRef.name);
+        let querySchema = undefined;
+        const schema = this.options.schema;
+        if (schema) {
+            const tables = schema.getTables(sourceTable);
+            if (tables.length == 0) {
+                const e = new SqlRuleError(`Table ${sourceTable.schema}.${sourceTable.tablePattern} not found`, this.sql, stmt.from?.[0]?._location);
+                e.type = 'warning';
+                this.errors.push(e);
+            }
+            else {
+                querySchema = new TableQuerySchema(tables, alias);
+            }
+        }
+        return {
+            query: stmt,
+            tableRef,
+            alias,
+            querySchema,
+            sourceTable
+        };
+    }
+}
+function isScalarExpression(clause) {
+    return isRowValueClause(clause) || isStaticValueClause(clause) || isParameterValueClause(clause);
+}
+function recoverErrorClause(tools) {
+    // An error has already been logged.
+    return new EvaluateSimpleCondition(null, tools.compileClause(null));
+}
+function compiledClauseToFilter(tools, location, regularClause) {
+    if (isScalarExpression(regularClause)) {
+        return new EvaluateSimpleCondition(location ?? null, regularClause);
+    }
+    else if (isParameterMatchClause(regularClause)) {
+        return new CompareRowValueWithStreamParameter(location ?? null, regularClause);
+    }
+    else if (isClauseError(regularClause)) {
+        return recoverErrorClause(tools);
+    }
+    else {
+        throw new Error('Unknown clause type');
+    }
+}
+//# sourceMappingURL=from_sql.js.map

package/dist/streams/from_sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"from_sql.js","sourceRoot":"","sources":["../../src/streams/from_sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,UAAU,EACV,wBAAwB,EACxB,aAAa,EACb,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,EACV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAA8C,MAAM,wBAAwB,CAAC;AACtG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,GAAG,EACH,kCAAkC,EAClC,uBAAuB,EACvB,cAAc,EAEd,UAAU,EACV,GAAG,EACH,EAAE,EACF,eAAe,EAEf,QAAQ,EACT,MAAM,aAAa,CAAC;AACrB,OAAO,EAKL,KAAK,EAIN,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,UAAU,iBAAiB,CAC/B,cAAsB,EACtB,GAAW,EACX,OAA2B;IAE3B,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC,cAAc,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACtE,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,kBAAkB;IACtB,cAAc,CAAS;IACvB,GAAG,CAAS;IACZ,OAAO,CAAqB;IAE5B,MAAM,CAAiB;IAEvB,YAAY,cAAsB,EAAE,GAAW,EAAE,OAA2B;QAC1E,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,GAAG,oBAAoB,CAAC,YAAY,EAAE,CAAC;YAC3E,MAAM,IAAI,YAAY,CACpB,4GAA4G,EAC5G,IAAI,CAAC,GAAG,CACT,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,IAAI,EAAE,GAAG,WAAW,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3E,kDAAkD;QAClD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,YAAY,CAAC,6CAA6C,EAAE,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAC7G,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;QAElG,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC;YACzB,KAAK,EAAE,KAAK;YACZ,eAAe,EAAE,EAAE;YACnB,WAAW,EAAE,CAAC,KAAK,CAAC;YACpB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,MAAM,EAAE,WAAW;YACnB,kBAAkB,EAAE,gBAAgB;YACpC,oBAAoB,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa;YAChD,4BAA4B,EAAE,IAAI;YAClC,2BAA2B,EAAE,IAAI,CAAC,gEAAgE;SACnG,CAAC,CAAC;QACH,KAAK,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,GAAG,MAAM,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAE/C,MAAM,MAAM,GAAG,IAAI,UAAU,CAC3B,IAAI,CAAC,cAAc,EACnB,IAAI,gBAAgB,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAC9E,CAAC;QACF,MAAM,CAAC,qBAAqB,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC;QACpE,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,gBAAgB,CACtB,KAAe,EACf,KAA0B,EAC1B,KAAa,EACb,WAAyB;QAEzB,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,IAAI,UAAU,GAAwB,EAAE,CAAC;QACzC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;QAEjC,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;gBAChB,MAAM,MAAM,GAAG,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC3D,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC1B,uBAAuB;oBACvB,SAAS;gBACX,CAAC;gBACD,UAAU,CAAC,IAAI,CAAC;oBACd,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;wBAC1B,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBACzC,CAAC;oBACD,QAAQ,CAAC,MAAM,EAAE,IAAI;wBACnB,MAAM,GAAG,GAAG,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;wBAE/C,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,IAAI,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC;oBACjG,CAAC;iBACF,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,IAAI,CAAC;oBACd,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;wBAC1B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;wBAC1B,KAAK,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;4BACpB,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gCACxB,SAAS;4BACX,CAAC;4BACD,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;wBAC3B,CAAC;oBACH,CAAC;oBACD,QAAQ,CAAC,MAAM,EAAE,IAAI;wBACnB,KAAK,IAAI,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;4BAC5C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC;wBAC/B,CAAC;oBACH,CAAC;iBACF,CAAC,CAAC;YACL,CAAC;YACD,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;gBACjB,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;iBAAM,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;gBACvB,WAAW,GAAG,IAAI,CAAC;gBACnB,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;oBACxB,iEAAiE;oBACjE,KAAK,GAAG,IAAI,CAAC;gBACf,CAAC;qBAAM,CAAC;oBACN,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI,cAAc,CAAC,IAAI,CAAC;oBAC/E,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;wBACrB,KAAK,GAAG,IAAI,CAAC;oBACf,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,kCAAkC,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAC3G,IAAI,WAAW,EAAE,CAAC;gBAChB,+CAA+C;gBAC/C,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC;YACzB,CAAC;YACD,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO;YACL,WAAW;YACX,KAAK,EAAE,KAAK;YACZ,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;YAC5B,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,KAAK;YACL,UAAU;YACV,kHAAkH;YAClH,mEAAmE;YACnE,gBAAgB,EAAE,EAAE;SACa,CAAC;IACtC,CAAC;IAEO,wBAAwB,CAAC,IAAyB;QACxD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,wBAAwB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IAChE,CAAC;IAEO,oBAAoB,CAAC,KAAe,EAAE,MAAkB;QAC9D,mDAAmD;QACnD,oHAAoH;QACpH,mHAAmH;QACnH,gBAAgB;QAChB,+CAA+C;QAC/C,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,IAAI,MAAM,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,IAAI,QAAQ,EAAE,gBAAgB,CAAC;gBAE/B,IAAI,MAAM,CAAC,EAAE,IAAI,KAAK,EAAE,CAAC;oBACvB,QAAQ,GAAG,GAAG,CAAC;oBACf,gBAAgB,GAAG,UAAU,CAAC;gBAChC,CAAC;qBAAM,IAAI,MAAM,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;oBAC7B,QAAQ,GAAG,EAAE,CAAC;oBACd,gBAAgB,GAAG,SAAS,CAAC;gBAC/B,CAAC;qBAAM,IAAI,MAAM,CAAC,EAAE,IAAI,IAAI,IAAI,MAAM,CAAC,EAAE,IAAI,QAAQ,EAAE,CAAC;oBACtD,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;oBACrD,OAAO,MAAM,CAAC,EAAE,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBACpF,CAAC;qBAAM,IAAI,MAAM,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;oBAC7B,OAAO,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBACpD,CAAC;gBAED,iGAAiG;gBACjG,IAAI,QAAQ,IAAI,gBAAgB,EAAE,CAAC;oBACjC,MAAM,IAAI,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;oBAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;oBAE7D,IAAI,IAAI,YAAY,uBAAuB,IAAI,KAAK,YAAY,uBAAuB,EAAE,CAAC;wBACxF,IAAI,iBAAiB,CAAC;wBAEtB,IAAI,CAAC;4BACH,iBAAiB,GAAG,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;wBAC1E,CAAC;wBAAC,OAAO,CAAC,EAAE,CAAC;4BACX,0GAA0G;4BAC1G,sDAAsD;wBACxD,CAAC;wBAED,IAAI,iBAAiB,IAAI,kBAAkB,CAAC,iBAAiB,CAAC,EAAE,CAAC;4BAC/D,OAAO,IAAI,uBAAuB,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,EAAE,iBAAiB,CAAC,CAAC;wBAClF,CAAC;oBACH,CAAC;oBAED,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;gBAClC,IAAI,MAAM,CAAC,EAAE,IAAI,KAAK,EAAE,CAAC;oBACvB,MAAM,KAAK,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;oBAC/D,IAAI,KAAK,YAAY,uBAAuB,EAAE,CAAC;wBAC7C,oCAAoC;wBACpC,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC7B,CAAC;yBAAM,CAAC;wBACN,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC;oBAClD,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,IAAI,IAAI,EAAE,aAAa,CAAC,CAAC;IACjF,CAAC;IAEO,iBAAiB,CAAC,KAAe,EAAE,MAAkB;QAC3D,gFAAgF;QAChF,EAAE;QACF,mHAAmH;QACnH,8HAA8H;QAC9H,+FAA+F;QAC/F,yFAAyF;QACzF,4GAA4G;QAC5G,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC;QAC1C,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC;YAClC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzB,KAAK,CAAC,KAAK,CACT,wHAAwH,EACxH,MAAM,CAAC,IAAI,CACZ,CAAC;gBACJ,CAAC;gBAED,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;YAED,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1D,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;YACD,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,cAAc,CAAC;YAEjD,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,KAAK,CAAC,KAAK,CACT,iGAAiG,EACjG,MAAM,CAAC,IAAI,CACZ,CAAC;gBACF,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;YAED,IAAI,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjC,8GAA8G;gBAC9G,2GAA2G;gBAC3G,0GAA0G;gBAC1G,4GAA4G;gBAC5G,MAAM,gBAAgB,GAAG,aAAa,CAAC,oBAAoB,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACnF,QAAQ,CAAC,SAAS,CAAC,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC;gBAClF,OAAO,IAAI,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAChD,CAAC;iBAAM,CAAC;gBACN,SAAS;gBACT,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEhD,oHAAoH;QACpH,sHAAsH;QACtH,4EAA4E;QAC5E,MAAM,QAAQ,GAAG,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/E,OAAO,sBAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAEO,sBAAsB,CAAC,KAAe,EAAE,MAAkB;QAChE,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC;QAE1C,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC;YAClC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzB,KAAK,CAAC,KAAK,CAAC,6EAA6E,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC1G,CAAC;gBAED,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;YAED,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1D,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;YACD,MAAM,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC;YAClC,OAAO,IAAI,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEhD,qHAAqH;QACrH,sHAAsH;QACtH,4EAA4E;QAC5E,MAAM,QAAQ,GAAG,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACpF,OAAO,sBAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAEO,eAAe,CAAC,IAAqB;QAC3C,mHAAmH;QACnH,gHAAgH;QAChH,sBAAsB;QACtB,IAAI,SAAS,CAAC;QACd,IAAI,CAAC;YACH,SAAS,GAAG,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,YAAY,EAAE,CAAC;gBAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtB,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;QACvE,6FAA6F;QAC7F,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC;YACzB,KAAK,EAAE,KAAK;YACZ,eAAe,EAAE,EAAE;YACnB,WAAW,EAAE,CAAC,KAAK,CAAC;YACpB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,MAAM,EAAE,WAAW;YACnB,4BAA4B,EAAE,IAAI;YAClC,oBAAoB,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa;YAChD,kBAAkB,EAAE,gBAAgB;SACrC,CAAC,CAAC;QACH,KAAK,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAEtC,IAAI,KAAK,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,KAAK,CAAC,8CAA8C,EAAE,KAAK,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACxE,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAE/C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAClH,CAAC;IAEO,yBAAyB,CAAC,IAAe;QAC/C,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,YAAY,CAAC,sCAAsC,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;YAC/E,MAAM,IAAI,YAAY,CAAC,iCAAiC,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;QAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrC,IAAI,QAAQ,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC;YAC3B,MAAM,IAAI,YAAY,CAAC,iCAAiC,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAChG,CAAC;QACD,MAAM,KAAK,GAAW,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC;QAEtD,MAAM,WAAW,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnG,IAAI,WAAW,GAA4B,SAAS,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACnC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YAC7C,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,GAAG,IAAI,YAAY,CACxB,SAAS,WAAW,CAAC,MAAM,IAAI,WAAW,CAAC,YAAY,YAAY,EACnE,IAAI,CAAC,GAAG,EACR,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAC1B,CAAC;gBACF,CAAC,CAAC,IAAI,GAAG,SAAS,CAAC;gBAEnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,WAAW,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,IAAI;YACX,QAAQ;YACR,KAAK;YACL,WAAW;YACX,WAAW;SACZ,CAAC;IACJ,CAAC;CACF;AAED,SAAS,kBAAkB,CAAC,MAAsB;IAChD,OAAO,gBAAgB,CAAC,MAAM,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC;AACnG,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAe;IACzC,oCAAoC;IACpC,OAAO,IAAI,uBAAuB,CAAC,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,IAAI,CAAsB,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAe,EAAE,QAA4B,EAAE,aAA6B;IAC1G,IAAI,kBAAkB,CAAC,aAAa,CAAC,EAAE,CAAC;QACtC,OAAO,IAAI,uBAAuB,CAAC,QAAQ,IAAI,IAAI,EAAE,aAAa,CAAC,CAAC;IACtE,CAAC;SAAM,IAAI,sBAAsB,CAAC,aAAa,CAAC,EAAE,CAAC;QACjD,OAAO,IAAI,kCAAkC,CAAC,QAAQ,IAAI,IAAI,EAAE,aAAa,CAAC,CAAC;IACjF,CAAC;SAAM,IAAI,aAAa,CAAC,aAAa,CAAC,EAAE,CAAC;QACxC,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;AACH,CAAC"}

package/dist/streams/functions.d.ts

@@ -0,0 +1,2 @@
+import { SqlParameterFunction } from '../request_functions.js';
+export declare const STREAM_FUNCTIONS: Record<string, Record<string, SqlParameterFunction>>;

package/dist/streams/functions.js

@@ -0,0 +1,38 @@
+import { globalRequestParameterFunctions, parameterFunctions, request_user_id } from '../request_functions.js';
+export const STREAM_FUNCTIONS = {
+    subscription: {
+        ...parameterFunctions({
+            schema: 'subscription',
+            extractJsonString: function (v) {
+                return v.rawStreamParameters ?? '{}';
+            },
+            extractJsonParsed: function (v) {
+                return v.streamParameters ?? {};
+            },
+            sourceDescription: 'Unauthenticated subscription parameters as JSON',
+            sourceDocumentation: 'parameters passed by the client for this stream as a JSON string. These parameters are not authenticated - any value can be passed in by the client.',
+            usesAuthenticatedRequestParameters: false,
+            usesUnauthenticatedRequestParameters: true
+        })
+    },
+    connection: {
+        ...globalRequestParameterFunctions('connection')
+    },
+    auth: {
+        user_id: request_user_id,
+        ...parameterFunctions({
+            schema: 'auth',
+            extractJsonString: function (v) {
+                return v.rawTokenPayload;
+            },
+            extractJsonParsed: function (v) {
+                return v.tokenParameters;
+            },
+            sourceDescription: 'JWT payload as JSON',
+            sourceDocumentation: 'JWT payload as a JSON string. This is always validated against trusted keys',
+            usesAuthenticatedRequestParameters: true,
+            usesUnauthenticatedRequestParameters: false
+        })
+    }
+};
+//# sourceMappingURL=functions.js.map

package/dist/streams/functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../src/streams/functions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,kBAAkB,EAClB,eAAe,EAEhB,MAAM,yBAAyB,CAAC;AAGjC,MAAM,CAAC,MAAM,gBAAgB,GAAyD;IACpF,YAAY,EAAE;QACZ,GAAG,kBAAkB,CAAC;YACpB,MAAM,EAAE,cAAc;YACtB,iBAAiB,EAAE,UAAU,CAAoB;gBAC/C,OAAO,CAAC,CAAC,mBAAmB,IAAI,IAAI,CAAC;YACvC,CAAC;YACD,iBAAiB,EAAE,UAAU,CAAoB;gBAC/C,OAAO,CAAC,CAAC,gBAAgB,IAAI,EAAE,CAAC;YAClC,CAAC;YACD,iBAAiB,EAAE,iDAAiD;YACpE,mBAAmB,EACjB,sJAAsJ;YACxJ,kCAAkC,EAAE,KAAK;YACzC,oCAAoC,EAAE,IAAI;SAC3C,CAAC;KACH;IACD,UAAU,EAAE;QACV,GAAG,+BAA+B,CAAC,YAAY,CAAC;KACjD;IACD,IAAI,EAAE;QACJ,OAAO,EAAE,eAAe;QACxB,GAAG,kBAAkB,CAAC;YACpB,MAAM,EAAE,MAAM;YACd,iBAAiB,EAAE,UAAU,CAAoB;gBAC/C,OAAO,CAAC,CAAC,eAAe,CAAC;YAC3B,CAAC;YACD,iBAAiB,EAAE,UAAU,CAAoB;gBAC/C,OAAO,CAAC,CAAC,eAAe,CAAC;YAC3B,CAAC;YACD,iBAAiB,EAAE,qBAAqB;YACxC,mBAAmB,EAAE,6EAA6E;YAClG,kCAAkC,EAAE,IAAI;YACxC,oCAAoC,EAAE,KAAK;SAC5C,CAAC;KACH;CACF,CAAC"}

package/dist/streams/parameter.d.ts

@@ -0,0 +1,67 @@
+import { ParameterLookup } from '../BucketParameterQuerier.js';
+import { SourceTableInterface } from '../SourceTableInterface.js';
+import { TablePattern } from '../TablePattern.js';
+import { ParameterValueSet, RequestParameters, SqliteJsonValue, SqliteRow, SqliteValue, TableRow } from '../types.js';
+/**
+ * A source of parameterization, causing data from the source table to be distributed into multiple buckets instead of
+ * a single one.
+ *
+ * Parameters are introduced when the select statement defining the stream has a where clause with elements where:
+ *
+ *   1. Values in the row to sync are compared against request parameters: {@link CompareRowValueWithStreamParameter}.
+ *   2. Values in the row to sync are compared against a subquery: {@link InOperator}.
+ */
+export interface BucketParameter {
+    lookup: StaticLookup | EqualsRowInSubqueryLookup | OverlapsSubqueryLookup;
+    /**
+     * Given a row in the table the stream is selecting from, return all possible instantiations of this parameter that
+     * would match the row.
+     *
+     * This is used to assign rows to buckets. For instance, considering the query
+     * `SELECT * FROM asset WHERE owner = request.user_id()`, we would introduce a parameter. For that parameter,
+     * `filterRow(assetRow)` would return `assetRow.owner`.
+     * When a user connects, {@link StaticLookup.fromRequest} would return the user ID from the token. A matching bucket would
+     * then contain the oplog data for assets with the matching `owner` column.
+     */
+    filterRow(row: TableRow): SqliteJsonValue[];
+}
+export interface SubqueryEvaluator {
+    parameterTable: TablePattern;
+    lookupsForParameterRow(sourceTable: SourceTableInterface, row: SqliteRow): SubqueryLookups | null;
+    lookupsForRequest(params: RequestParameters): ParameterLookup[];
+}
+export interface SubqueryLookups {
+    lookups: ParameterLookup[];
+    /**
+     * The value that the single column in the subquery evaluated to.
+     */
+    value: SqliteJsonValue;
+}
+/**
+ * An association of rows to subscription parameters that does not depend on a subquery.
+ */
+export interface StaticLookup {
+    type: 'static';
+    /**
+     * The value this lookup evaluates to for a specific request.
+     *
+     * This is typically a singleton array, e.g. the user's id in `WHERE owner_id = token.user_id()`. To desugar `IN`
+     * queries on parameter data, this can also return multiple values though: `WHERE owner_id IN subscription.parameters() -> 'user_ids'`.
+     */
+    fromRequest(parameters: ParameterValueSet): SqliteValue[];
+}
+/**
+ * An association of rows that is matched if a value in the source row is contained in the results of a subquery.
+ */
+export interface EqualsRowInSubqueryLookup {
+    type: 'in';
+    subquery: SubqueryEvaluator;
+}
+/**
+ * An association of rows that is matched if a source-row value (interpreted as a JSON array) overlaps with rows
+ * contained in the results of a subqery.
+ */
+export interface OverlapsSubqueryLookup {
+    type: 'overlap';
+    subquery: SubqueryEvaluator;
+}

package/dist/streams/parameter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parameter.js.map

package/dist/streams/parameter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter.js","sourceRoot":"","sources":["../../src/streams/parameter.ts"],"names":[],"mappings":""}

package/dist/streams/stream.d.ts

@@ -0,0 +1,40 @@
+import { BaseSqlDataQuery } from '../BaseSqlDataQuery.js';
+import { BucketPriority } from '../BucketDescription.js';
+import { PendingQueriers } from '../BucketParameterQuerier.js';
+import { BucketSource, BucketSourceType } from '../BucketSource.js';
+import { ColumnDefinition } from '../ExpressionType.js';
+import { SourceTableInterface } from '../SourceTableInterface.js';
+import { GetQuerierOptions } from '../SqlSyncRules.js';
+import { TablePattern } from '../TablePattern.js';
+import { EvaluatedParametersResult, EvaluateRowOptions, EvaluationResult, SourceSchema, SqliteRow } from '../types.js';
+import { StreamVariant } from './variant.js';
+export declare class SyncStream implements BucketSource {
+    name: string;
+    subscribedToByDefault: boolean;
+    priority: BucketPriority;
+    variants: StreamVariant[];
+    data: BaseSqlDataQuery;
+    constructor(name: string, data: BaseSqlDataQuery);
+    get type(): BucketSourceType;
+    pushBucketParameterQueriers(result: PendingQueriers, options: GetQuerierOptions): void;
+    private queriersForSubscription;
+    hasDynamicBucketQueries(): boolean;
+    tableSyncsData(table: SourceTableInterface): boolean;
+    tableSyncsParameters(table: SourceTableInterface): boolean;
+    getSourceTables(): Set<TablePattern>;
+    resolveResultSets(schema: SourceSchema, tables: Record<string, Record<string, ColumnDefinition>>): void;
+    debugRepresentation(): {
+        name: string;
+        type: string;
+        variants: any[];
+        data: {
+            table: TablePattern;
+            columns: string[];
+        };
+    };
+    debugWriteOutputTables(result: Record<string, {
+        query: string;
+    }[]>): void;
+    evaluateParameterRow(sourceTable: SourceTableInterface, row: SqliteRow): EvaluatedParametersResult[];
+    evaluateRow(options: EvaluateRowOptions): EvaluationResult[];
+}