@powersync/service-sync-rules 0.28.0 → 0.29.0

package/dist/types/time.d.ts

@@ -0,0 +1,33 @@
+import { SqliteValueType } from '../ExpressionType.js';
+import { CompatibilityContext } from '../compatibility.js';
+import { SqliteValue } from '../types.js';
+import { CustomSqliteValue } from './custom_sqlite_value.js';
+/**
+ * In old versions of the sync service, timestamp values were formatted with a space between the date and time
+ * components.
+ *
+ * This is not ISO 6801 compatible, but changing it would be breaking existing users. So, this option is opt-in and
+ * disabled by default until a major upgrade.
+ */
+export declare class DateTimeValue extends CustomSqliteValue {
+    readonly iso8601Representation: string;
+    private readonly fixedLegacyRepresentation;
+    constructor(iso8601Representation: string, fixedLegacyRepresentation?: string | undefined);
+    get legacyRepresentation(): string;
+    get sqliteType(): SqliteValueType;
+    toSqliteValue(context: CompatibilityContext): string;
+}
+/**
+ * In old versions of the sync service, time values didn't consistently contain a sub-second interval.
+ *
+ * A value like `12:13:14.156789` would be represented as-is, but `12:13:14.000000` would be synced as `12:13:14`. This
+ * is undesirable because it means that sorting values alphabetically doesn't preserve their value.
+ */
+export declare class TimeValue extends CustomSqliteValue {
+    readonly timeSeconds: string;
+    readonly fraction: string | undefined;
+    constructor(timeSeconds: string, fraction?: string | undefined);
+    static parse(value: string): TimeValue | null;
+    toSqliteValue(context: CompatibilityContext): SqliteValue;
+    get sqliteType(): SqliteValueType;
+}

package/dist/types/time.js

@@ -0,0 +1,67 @@
+import { CompatibilityOption } from '../compatibility.js';
+import { CustomSqliteValue } from './custom_sqlite_value.js';
+/**
+ * In old versions of the sync service, timestamp values were formatted with a space between the date and time
+ * components.
+ *
+ * This is not ISO 6801 compatible, but changing it would be breaking existing users. So, this option is opt-in and
+ * disabled by default until a major upgrade.
+ */
+export class DateTimeValue extends CustomSqliteValue {
+    iso8601Representation;
+    fixedLegacyRepresentation;
+    // YYYY-MM-DDThh:mm:ss.sss / YYYY-MM-DDThh:mm:ss.sssZ
+    constructor(iso8601Representation, fixedLegacyRepresentation = undefined) {
+        super();
+        this.iso8601Representation = iso8601Representation;
+        this.fixedLegacyRepresentation = fixedLegacyRepresentation;
+    }
+    // YYYY-MM-DD hh:mm:ss.sss / YYYY-MM-DD hh:mm:ss.sssZ
+    get legacyRepresentation() {
+        return this.fixedLegacyRepresentation ?? this.iso8601Representation.replace('T', ' ');
+    }
+    get sqliteType() {
+        return 'text';
+    }
+    toSqliteValue(context) {
+        return context.isEnabled(CompatibilityOption.timestampsIso8601)
+            ? this.iso8601Representation
+            : this.legacyRepresentation;
+    }
+}
+/**
+ * In old versions of the sync service, time values didn't consistently contain a sub-second interval.
+ *
+ * A value like `12:13:14.156789` would be represented as-is, but `12:13:14.000000` would be synced as `12:13:14`. This
+ * is undesirable because it means that sorting values alphabetically doesn't preserve their value.
+ */
+export class TimeValue extends CustomSqliteValue {
+    timeSeconds;
+    fraction;
+    constructor(timeSeconds, fraction = undefined) {
+        super();
+        this.timeSeconds = timeSeconds;
+        this.fraction = fraction;
+    }
+    static parse(value) {
+        const match = /^([\d:]+)(\.\d+)?$/.exec(value);
+        if (match == null) {
+            return null;
+        }
+        const [_, timeSeconds, fraction] = match;
+        return new TimeValue(timeSeconds, fraction);
+    }
+    toSqliteValue(context) {
+        if (context.isEnabled(CompatibilityOption.timestampsIso8601)) {
+            const fraction = this.fraction?.padEnd(7, '0') ?? '.000000';
+            return `${this.timeSeconds}${fraction}`;
+        }
+        else {
+            return `${this.timeSeconds}${this.fraction ?? ''}`;
+        }
+    }
+    get sqliteType() {
+        return 'text';
+    }
+}
+//# sourceMappingURL=time.js.map

package/dist/types/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/types/time.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,OAAO,aAAc,SAAQ,iBAAiB;IAIvC;IACQ;IAJnB,qDAAqD;IAErD,YACW,qBAA6B,EACrB,4BAAgD,SAAS;QAE1E,KAAK,EAAE,CAAC;QAHC,0BAAqB,GAArB,qBAAqB,CAAQ;QACrB,8BAAyB,GAAzB,yBAAyB,CAAgC;IAG5E,CAAC;IAED,qDAAqD;IACrD,IAAW,oBAAoB;QAC7B,OAAO,IAAI,CAAC,yBAAyB,IAAI,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACxF,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,aAAa,CAAC,OAA6B;QACzC,OAAO,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,iBAAiB,CAAC;YAC7D,CAAC,CAAC,IAAI,CAAC,qBAAqB;YAC5B,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;IAChC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,SAAU,SAAQ,iBAAiB;IAEnC;IACA;IAFX,YACW,WAAmB,EACnB,WAA+B,SAAS;QAEjD,KAAK,EAAE,CAAC;QAHC,gBAAW,GAAX,WAAW,CAAQ;QACnB,aAAQ,GAAR,QAAQ,CAAgC;IAGnD,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,KAAa;QACxB,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,GAAG,KAAY,CAAC;QAChD,OAAO,IAAI,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,aAAa,CAAC,OAA6B;QACzC,IAAI,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC;YAC5D,OAAO,GAAG,IAAI,CAAC,WAAW,GAAG,QAAQ,EAAE,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACrD,CAAC;IACH,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/types.d.ts

@@ -5,6 +5,8 @@ import { SyncRulesOptions } from './SqlSyncRules.js';
 import { TablePattern } from './TablePattern.js';
 import { BucketPriority } from './BucketDescription.js';
 import { ParameterLookup } from './BucketParameterQuerier.js';
+import { CustomSqliteValue } from './types/custom_sqlite_value.js';
+import { CompatibilityContext } from './compatibility.js';
 export interface SyncRules {
     evaluateRow(options: EvaluateRowOptions): EvaluationResult[];
     evaluateParameterRow(table: SourceTableInterface, row: SqliteRow): EvaluatedParametersResult[];
@@ -12,6 +14,10 @@ export interface SyncRules {
 export interface QueryParseOptions extends SyncRulesOptions {
     accept_potentially_dangerous_queries?: boolean;
     priority?: BucketPriority;
+    compatibility: CompatibilityContext;
+}
+export interface StreamParseOptions extends QueryParseOptions {
+    auto_subscribe?: boolean;
 }
 export interface EvaluatedParameters {
     lookup: ParameterLookup;
@@ -54,10 +60,17 @@ export interface ParameterValueSet {
      * JSON string of raw request parameters.
      */
     rawUserParameters: string;
+    userParameters: SqliteJsonRow;
+    /**
+     * For streams, the raw JSON string of stream parameters.
+     */
+    rawStreamParameters: string | null;
+    streamParameters: SqliteJsonRow | null;
     /**
      * JSON string of raw request parameters.
      */
     rawTokenPayload: string;
+    tokenParameters: SqliteJsonRow;
     userId: string;
 }
 export declare class RequestParameters implements ParameterValueSet {
@@ -67,13 +80,17 @@ export declare class RequestParameters implements ParameterValueSet {
      * JSON string of raw request parameters.
      */
     rawUserParameters: string;
+    streamParameters: SqliteJsonRow | null;
+    rawStreamParameters: string | null;
     /**
      * JSON string of raw request parameters.
      */
     rawTokenPayload: string;
     userId: string;
     constructor(tokenPayload: RequestJwtPayload, clientParameters: Record<string, any>);
+    constructor(params: RequestParameters);
     lookup(table: string, column: string): SqliteJsonValue;
+    withAddedStreamParameters(params: Record<string, any>): RequestParameters;
 }
 /**
  * A value that is both SQLite and JSON-compatible.
@@ -85,6 +102,11 @@ export type SqliteJsonValue = number | string | bigint | null;
  * A value supported by the SQLite type system.
  */
 export type SqliteValue = number | string | null | bigint | Uint8Array;
+/**
+ * A value that is either supported by SQLite natively, or one that can be lowered into a SQLite-value given additional
+ * context.
+ */
+export type SqliteInputValue = SqliteValue | CustomSqliteValue;
 /**
  * A set of values that are both SQLite and JSON-compatible.
  *
@@ -97,22 +119,21 @@ export type SqliteJsonRow = {
  * SQLite-compatible row (NULL, TEXT, INTEGER, REAL, BLOB).
  * JSON is represented as TEXT.
  */
-export type SqliteRow = {
-    [column: string]: SqliteValue;
+export type SqliteRow<T = SqliteValue> = {
+    [column: string]: T;
 };
+export type SqliteInputRow = SqliteRow<SqliteInputValue>;
 /**
  * SQLite-compatible row (NULL, TEXT, INTEGER, REAL, BLOB).
  * JSON is represented as TEXT.
  *
  * Toasted values are `undefined`.
  */
-export type ToastableSqliteRow = {
-    [column: string]: SqliteValue | undefined;
-};
+export type ToastableSqliteRow<V = SqliteInputValue> = SqliteRow<V | undefined>;
 /**
  * A value as received from the database.
  */
-export type DatabaseInputValue = SqliteValue | boolean | DatabaseInputValue[] | JsonContainer | {
+export type DatabaseInputValue = SqliteValue | boolean | DatabaseInputValue[] | JsonContainer | CustomSqliteValue | {
     [key: string]: DatabaseInputValue;
 };
 /**
@@ -166,12 +187,31 @@ export interface InputParameter {
      */
     parametersToLookupValue(parameters: ParameterValueSet): SqliteValue;
 }
-export interface EvaluateRowOptions {
+/**
+ * Transforms bucket ids generated when evaluating the row by e.g. encoding version information.
+ *
+ * Because buckets are recreated on a sync rule redeploy, it makes sense to use different bucket ids (otherwise, clients
+ * may run into checksum errors causing a sync to take longer than necessary or breaking progress).
+ *
+ * So, this transformer receives the original bucket id as generated by defined sync rules, and can prepend a version
+ * identifier.
+ *
+ * Note that this transformation has not been present in older versions of the sync service. To preserve backwards
+ * compatibility, sync rules will not use this function without an opt-in.
+ */
+export type BucketIdTransformer = (regularId: string) => string;
+export interface EvaluateRowOptions extends TableRow {
+    bucketIdTransformer: BucketIdTransformer;
+}
+/**
+ * A row associated with the table it's coming from.
+ */
+export interface TableRow<R = SqliteRow> {
     sourceTable: SourceTableInterface;
-    record: SqliteRow;
+    record: R;
 }
 /**
- * This is a clause that matches row and parameter values.
+ * This is a clause that matches row and parameter values for equality.
  *
  * Example:
  * [WHERE] users.org_id = bucket.org_id
@@ -186,6 +226,9 @@ export interface ParameterMatchClause {
      *  * ['token_parameters.user_id'] for a parameter query
      *
      * These parameters are always matched by this clause, and no additional parameters are matched.
+     *
+     * For a single match clause, this array will have a single element. When match clauses are combined with `AND`,
+     * the result is represented as a {@link ParameterMatchClause} with multiple input parameters.
      */
     inputParameters: InputParameter[];
     /**

package/dist/types.js

@@ -1,5 +1,6 @@
 import { JSONBig } from '@powersync/service-jsonbig';
 import { toSyncRulesParameters } from './utils.js';
+import { CompatibilityContext } from './compatibility.js';
 export function isEvaluationError(e) {
     return typeof e.error == 'string';
 }
@@ -16,12 +17,24 @@ export class RequestParameters {
      * JSON string of raw request parameters.
      */
     rawUserParameters;
+    streamParameters;
+    rawStreamParameters;
     /**
      * JSON string of raw request parameters.
      */
     rawTokenPayload;
     userId;
     constructor(tokenPayload, clientParameters) {
+        if (tokenPayload instanceof RequestParameters) {
+            this.tokenParameters = tokenPayload.tokenParameters;
+            this.userParameters = tokenPayload.userParameters;
+            this.rawUserParameters = tokenPayload.rawUserParameters;
+            this.rawTokenPayload = tokenPayload.rawTokenPayload;
+            this.streamParameters = tokenPayload.streamParameters;
+            this.rawStreamParameters = tokenPayload.rawStreamParameters;
+            this.userId = tokenPayload.userId;
+            return;
+        }
         // This type is verified when we verify the token
         const legacyParameters = tokenPayload.parameters;
         const tokenParameters = {
@@ -29,11 +42,15 @@ export class RequestParameters {
             // sub takes presedence over any embedded parameters
             user_id: tokenPayload.sub
         };
-        this.tokenParameters = toSyncRulesParameters(tokenParameters);
+        // Client and token parameters don't contain DateTime values or other custom types, so we don't need to consider
+        // compatibility.
+        this.tokenParameters = toSyncRulesParameters(tokenParameters, CompatibilityContext.FULL_BACKWARDS_COMPATIBILITY);
         this.userId = tokenPayload.sub;
         this.rawTokenPayload = JSONBig.stringify(tokenPayload);
         this.rawUserParameters = JSONBig.stringify(clientParameters);
-        this.userParameters = toSyncRulesParameters(clientParameters);
+        this.userParameters = toSyncRulesParameters(clientParameters, CompatibilityContext.FULL_BACKWARDS_COMPATIBILITY);
+        this.streamParameters = null;
+        this.rawStreamParameters = null;
     }
     lookup(table, column) {
         if (table == 'token_parameters') {
@@ -42,7 +59,16 @@ export class RequestParameters {
         else if (table == 'user_parameters') {
             return this.userParameters[column];
         }
+        else if (table == 'subscription_parameters' && this.streamParameters != null) {
+            return this.streamParameters[column];
+        }
         throw new Error(`Unknown table: ${table}`);
     }
+    withAddedStreamParameters(params) {
+        const clone = new RequestParameters(this);
+        clone.streamParameters = params;
+        clone.rawStreamParameters = JSONBig.stringify(params);
+        return clone;
+    }
 }
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAiB,MAAM,4BAA4B,CAAC;AAKpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA+CnD,MAAM,UAAU,iBAAiB,CAAC,CAAM;IACtC,OAAO,OAAO,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAmB;IAChD,OAAO,OAAQ,CAAkB,CAAC,MAAM,IAAI,QAAQ,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,CAA4B;IAChE,OAAO,QAAQ,IAAI,CAAC,CAAC;AACvB,CAAC;AA6BD,MAAM,OAAO,iBAAiB;IAC5B,eAAe,CAAgB;IAC/B,cAAc,CAAgB;IAE9B;;OAEG;IACH,iBAAiB,CAAS;IAE1B;;OAEG;IACH,eAAe,CAAS;IAExB,MAAM,CAAS;IAEf,YAAY,YAA+B,EAAE,gBAAqC;QAChF,iDAAiD;QACjD,MAAM,gBAAgB,GAAG,YAAY,CAAC,UAA6C,CAAC;QAEpF,MAAM,eAAe,GAAG;YACtB,GAAG,gBAAgB;YACnB,oDAAoD;YACpD,OAAO,EAAE,YAAY,CAAC,GAAG;SAC1B,CAAC;QAEF,IAAI,CAAC,eAAe,GAAG,qBAAqB,CAAC,eAAe,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC;QAC/B,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAEvD,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC7D,IAAI,CAAC,cAAc,GAAG,qBAAqB,CAAC,gBAAgB,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,MAAc;QAClC,IAAI,KAAK,IAAI,kBAAkB,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;aAAM,IAAI,KAAK,IAAI,iBAAiB,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;IAC7C,CAAC;CACF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.ts

@@ -1,8 +1,9 @@
 import { Replacer } from '@powersync/service-jsonbig';
 import { SelectFromStatement, Statement } from 'pgsql-ast-parser';
-import { DatabaseInputRow, SqliteJsonRow, SqliteJsonValue, SqliteRow, SqliteValue } from './types.js';
+import { DatabaseInputRow, DatabaseInputValue, SqliteInputValue, SqliteInputRow, SqliteJsonRow, SqliteJsonValue, SqliteRow, SqliteValue, BucketIdTransformer } from './types.js';
+import { CompatibilityContext } from './compatibility.js';
 export declare function isSelectStatement(q: Statement): q is SelectFromStatement;
-export declare function getBucketId(descriptor_id: string, bucket_parameters: string[], params: Record<string, SqliteJsonValue>): string;
+export declare function getBucketId(descriptor_id: string, bucket_parameters: string[], params: Record<string, SqliteJsonValue>, transformer: BucketIdTransformer): string;
 /**
  * SqliteRow -> SqliteJsonRow.
  *
@@ -16,24 +17,26 @@ export declare function filterJsonRow(data: SqliteRow): SqliteJsonRow;
  *
  * Types specifically not supported in output are `boolean` and `undefined`.
  */
-export declare function jsonValueToSqlite(value: null | undefined | string | number | bigint | boolean | any): SqliteValue;
+export declare function jsonValueToSqlite(fixedJsonBehavior: boolean, value: null | undefined | string | number | bigint | boolean | any): SqliteValue;
 export declare function isJsonValue(value: SqliteValue): value is SqliteJsonValue;
 /**
  * Map database row to SqliteRow for use in sync rules.
  */
-export declare function toSyncRulesRow(row: DatabaseInputRow): SqliteRow;
+export declare function toSyncRulesRow(row: DatabaseInputRow): SqliteInputRow;
 /**
  * Convert parameter query input to a SqliteJsonRow.
  *
  * @param parameters Generic JSON input
  */
-export declare function toSyncRulesParameters(parameters: Record<string, any>): SqliteJsonRow;
+export declare function toSyncRulesParameters(parameters: Record<string, any>, context: CompatibilityContext): SqliteJsonRow;
 /**
  * Convert to a SQLITE-equivalent value: NULL, TEXT, INTEGER, REAL or BLOB.
  *
  * Any object or array is converted to JSON TEXT.
  */
-export declare function toSyncRulesValue(data: any, autoBigNum?: boolean, keepUndefined?: boolean): SqliteValue;
+export declare function toSyncRulesValue(data: DatabaseInputValue, autoBigNum?: boolean, keepUndefined?: boolean): SqliteInputValue;
+export declare function applyValueContext(value: SqliteInputValue, context: CompatibilityContext): SqliteValue;
+export declare function applyRowContext<MaybeToast extends undefined = never>(value: SqliteRow<SqliteInputValue | MaybeToast>, context: CompatibilityContext): SqliteRow<SqliteValue | MaybeToast>;
 /**
  * Only use this for serializing bucket names. Bucket names should never be parsed except perhaps for debug purposes.
  *

package/dist/utils.js

@@ -1,13 +1,14 @@
 import { JSONBig, JsonContainer, stringifyRaw } from '@powersync/service-jsonbig';
 import { SQLITE_FALSE, SQLITE_TRUE } from './sql_support.js';
 import { SyncRuleProcessingError as SyncRulesProcessingError } from './errors.js';
+import { CustomArray, CustomObject, CustomSqliteValue } from './types/custom_sqlite_value.js';
 export function isSelectStatement(q) {
     return q.type == 'select';
 }
-export function getBucketId(descriptor_id, bucket_parameters, params) {
+export function getBucketId(descriptor_id, bucket_parameters, params, transformer) {
     // Important: REAL and INTEGER values matching the same number needs the same representation in the bucket name.
     const paramArray = bucket_parameters.map((name) => params[`bucket.${name}`]);
-    return `${descriptor_id}${JSONBucketNameSerialize.stringify(paramArray)}`;
+    return transformer(`${descriptor_id}${JSONBucketNameSerialize.stringify(paramArray)}`);
 }
 const DEPTH_LIMIT = 10;
 /**
@@ -32,11 +33,17 @@ export function filterJsonRow(data) {
  *
  * Types specifically not supported in output are `boolean` and `undefined`.
  */
-export function jsonValueToSqlite(value) {
+export function jsonValueToSqlite(fixedJsonBehavior, value) {
+    let isObject = typeof value == 'object';
+    if (fixedJsonBehavior) {
+        // With the fixed json behavior, make json_extract() not represent a null value as 'null' but instead use a SQL NULL
+        // value.
+        isObject = isObject && value != null;
+    }
     if (typeof value == 'boolean') {
         return value ? SQLITE_TRUE : SQLITE_FALSE;
     }
-    else if (typeof value == 'object' || Array.isArray(value)) {
+    else if (isObject || Array.isArray(value)) {
         // Objects and arrays must be stringified
         return JSONBig.stringify(value);
     }
@@ -47,7 +54,7 @@ export function jsonValueToSqlite(value) {
 export function isJsonValue(value) {
     return value == null || typeof value == 'string' || typeof value == 'number' || typeof value == 'bigint';
 }
-function filterJsonData(data, depth = 0) {
+function filterJsonData(data, context, depth = 0) {
     if (depth > DEPTH_LIMIT) {
         // This is primarily to prevent infinite recursion
         // TODO: Proper error class
@@ -68,7 +75,7 @@ function filterJsonData(data, depth = 0) {
         return data;
     }
     else if (Array.isArray(data)) {
-        return data.map((element) => filterJsonData(element, depth + 1));
+        return data.map((element) => filterJsonData(element, context, depth + 1));
     }
     else if (ArrayBuffer.isView(data)) {
         return undefined;
@@ -77,10 +84,13 @@ function filterJsonData(data, depth = 0) {
         // Can be stringified directly when using our JSONBig implementation
         return data;
     }
+    else if (data instanceof CustomSqliteValue) {
+        return data.toSqliteValue(context);
+    }
     else if (typeof data == 'object') {
         let record = {};
         for (let key of Object.keys(data)) {
-            record[key] = filterJsonData(data[key], depth + 1);
+            record[key] = filterJsonData(data[key], context, depth + 1);
         }
         return record;
     }
@@ -103,10 +113,10 @@ export function toSyncRulesRow(row) {
  *
  * @param parameters Generic JSON input
  */
-export function toSyncRulesParameters(parameters) {
+export function toSyncRulesParameters(parameters, context) {
     let record = {};
     for (let key of Object.keys(parameters)) {
-        record[key] = toSyncRulesValue(parameters[key], true, false);
+        record[key] = applyValueContext(toSyncRulesValue(parameters[key], true, false), context);
     }
     return record;
 }
@@ -141,26 +151,41 @@ export function toSyncRulesValue(data, autoBigNum, keepUndefined) {
         return data ? SQLITE_TRUE : SQLITE_FALSE;
     }
     else if (Array.isArray(data)) {
-        // We may be able to avoid some parse + stringify cycles here for JsonSqliteContainer.
-        return JSONBig.stringify(data.map((element) => filterJsonData(element)));
+        return new CustomArray(data, filterJsonData);
     }
-    else if (data instanceof Uint8Array) {
+    else if (data instanceof Uint8Array || data instanceof CustomSqliteValue) {
         return data;
     }
     else if (data instanceof JsonContainer) {
         return data.toString();
     }
     else if (typeof data == 'object') {
-        let record = {};
-        for (let key of Object.keys(data)) {
-            record[key] = filterJsonData(data[key]);
-        }
-        return JSONBig.stringify(record);
+        return new CustomObject(data, filterJsonData);
     }
     else {
         return null;
     }
 }
+export function applyValueContext(value, context) {
+    if (value instanceof CustomSqliteValue) {
+        return value.toSqliteValue(context);
+    }
+    else {
+        return value;
+    }
+}
+export function applyRowContext(value, context) {
+    let record = {};
+    for (let [key, rawValue] of Object.entries(value)) {
+        if (rawValue === undefined) {
+            record[key] = undefined;
+        }
+        else {
+            record[key] = applyValueContext(rawValue, context);
+        }
+    }
+    return record;
+}
 /**
  * Only use this for serializing bucket names. Bucket names should never be parsed except perhaps for debug purposes.
  *

package/dist/utils.js.map

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

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@powersync/service-sync-rules",
   "repository": "https://github.com/powersync-ja/powersync-service",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "license": "FSL-1.1-Apache-2.0",
+  "license": "FSL-1.1-ALv2",
   "publishConfig": {
     "access": "public"
   },
@@ -19,7 +19,7 @@
     "pgsql-ast-parser": "^11.1.0",
     "uuid": "^11.1.0",
     "yaml": "^2.3.1",
-    "@powersync/service-jsonbig": "^0.17.10"
+    "@powersync/service-jsonbig": "^0.17.11"
   },
   "devDependencies": {
     "@types/node": "^22.16.2",

package/schema/sync_rules.json

@@ -61,6 +61,50 @@
 				}
 			}
 		},
+		"streams": {
+			"type": "object",
+			"description": "List of stream definitions",
+			"examples": [
+				{
+					"user_details": {
+						"query": "select * from users where id = auth.user_id()"
+					}
+				}
+			],
+			"patternProperties": {
+				".*": {
+					"type": "object",
+					"required": [
+						"query"
+					],
+					"examples": [
+						{
+							"query": [
+								"select * from mytable"
+							]
+						}
+					],
+					"properties": {
+						"accept_potentially_dangerous_queries": {
+							"description": "If true, disables warnings on potentially dangerous queries",
+							"type": "boolean"
+						},
+						"auto_subscribe": {
+							"description": "Whether clients will subscribe to this stream by default.",
+							"type": "boolean"
+						},
+						"priority": {
+							"description": "Priority for the bucket (lower values indicate higher priority).",
+							"type": "integer"
+						},
+						"query": {
+							"description": "The SQL query defining content to sync in this stream.",
+							"type": "string"
+						}
+					}
+				}
+			}
+		},
 		"event_definitions": {
 			"type": "object",
 			"description": "Record of sync replication event definitions",
@@ -101,10 +145,44 @@
 					}
 				}
 			}
+		},
+		"config": {
+			"type": "object",
+			"description": "Config declaring the compatibility level used to parse these definitions.",
+			"properties": {
+				"edition": {
+					"type": "integer",
+					"default": 1,
+					"minimum": 1,
+					"exclusiveMaximum": 3
+				},
+				"timestamps_iso8601": {
+					"type": "boolean",
+					"description": "Enabled by default starting from edition 2: Consistently renders timestamps with an ISO 8601-compatible format (previous versions used a space instead of a T to separate date and time)."
+				},
+				"versioned_bucket_ids": {
+					"type": "boolean",
+					"description": "Enabled by default starting from edition 2: Encode the version of sync rules in generated bucket ids, which avoids clients downloading data twice and improves client-side progress estimates."
+				},
+				"fixed_json_extract": {
+					"type": "boolean",
+					"description": "Enabled by default starting from edition 2: 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 `.`."
+				}
+			},
+			"additionalProperties": false
 		}
 	},
-	"required": [
-		"bucket_definitions"
+	"anyOf": [
+		{
+			"required": [
+				"bucket_definitions"
+			]
+		},
+		{
+			"required": [
+				"streams"
+			]
+		}
 	],
 	"additionalProperties": false
 }