@powersync/service-sync-rules 0.43.0 → 0.44.0

package/dist/mongo/MongoBsonValidators.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Specialized payload checks attached directly to Zod schemas. Wrapper selection and recursion belong to the schema.
+ * This validates the filter's supported EJSON subset without replacing authored values with BSON instances.
+ * EJSON.deserialize alone is not a strict validator: the BSON library can coerce overflowing integers or
+ * normalize malformed base64 instead of rejecting them. Explicit bounds and syntax checks prevent those coercions;
+ * BSON still supplies Decimal128 representability and binary subtype checks where appropriate.
+ * Date strings deliberately retain the library's Date.parse behavior rather than strict calendar validation.
+ * See docs/replication/sync-config-parsing.md for the differences from general Extended JSON.
+ */
+export declare const MONGO_BSON_VALIDATORS: {
+    readonly mongoNumber: {
+        readonly type: "number";
+        /**
+         * Plain integer literals have an Int32 interpretation; larger integers must select an EJSON type explicitly.
+         */
+        readonly validate: (value: unknown) => void;
+    };
+    readonly mongoInt32: {
+        readonly type: "string";
+        /**
+         * Checks a canonical Int32 payload against its signed bounds.
+         * In BSON 6.10.4, EJSON.deserialize({ $numberInt: '2147483648' }, { relaxed: false })
+         * wraps to -2147483648. Default relaxed mode instead returns the out-of-range JS number 2147483648.
+         * Reject the overflow in either case rather than relying on deserialization to validate the bounds.
+         */
+        readonly validate: (value: unknown) => void;
+    };
+    readonly mongoInt64: {
+        readonly type: "string";
+        /**
+         * Checks a canonical Int64 payload using exact integer arithmetic.
+         * In BSON 6.10.4, EJSON.deserialize({ $numberLong: '9223372036854775808' }, { relaxed: false })
+         * wraps to Long(-9223372036854775808). Default relaxed mode also wraps, then loses precision when
+         * converting to a JS number. Checking with BigInt rejects the overflow before either conversion.
+         */
+        readonly validate: (value: unknown) => void;
+    };
+    readonly mongoDouble: {
+        readonly type: "string";
+        /**
+         * Rejects overflow to infinity after the schema checks decimal/exponent syntax.
+         */
+        readonly validate: (value: unknown) => void;
+    };
+    readonly mongoDecimal128: {
+        readonly type: "string";
+        /**
+         * Delegates representability to BSON rather than converting through a lossy JavaScript number.
+         */
+        readonly validate: (value: unknown) => void;
+    };
+    readonly mongoDateString: {
+        readonly type: "string";
+        /**
+         * Requires a finite timestamp after the schema checks the timestamp format and explicit timezone.
+         * BSON's EJSON date-string conversion also uses Date.parse, including its calendar normalization
+         * (for example, 2026-02-29 becomes March 1). This does not enforce strict calendar validity.
+         */
+        readonly validate: (value: unknown) => void;
+    };
+    readonly mongoDateMillis: {
+        readonly type: "string";
+        /**
+         * BSON dates are restored as JavaScript Date objects and must fit their supported millisecond range.
+         */
+        readonly validate: (value: unknown) => void;
+    };
+    readonly mongoBinary: {
+        readonly type: "object";
+        /**
+         * Checks BSON subtype constraints, including UUID byte length, after structural byte-encoding validation.
+         * BSON 6.10.4 accepts { $binary: { base64: 'AQI', subType: '0' } } in both relaxed and typed modes;
+         * re-serialization produces base64 'AQI=' and subtype '00'. The Zod schema rejects missing padding
+         * and one-digit subtypes independently before this check, requiring the canonical spelling we support.
+         */
+        readonly validate: (value: unknown) => void;
+    };
+};

package/dist/mongo/MongoBsonValidators.js

@@ -0,0 +1,129 @@
+import { Decimal128, EJSON } from 'bson';
+import { MongoFilterValidationError } from './MongoFilterValidation.js';
+/**
+ * Reports a payload error relative to the codec node; Zod supplies the surrounding source path.
+ */
+function fail(message) {
+    throw new MongoFilterValidationError({ path: [], message });
+}
+/**
+ * Checks integer-string bounds without losing Int64 precision. Syntax is constrained by the codec's pattern.
+ */
+function integerRange(value, minimum, maximum) {
+    if (typeof value != 'string' || !/^-?(?:0|[1-9][0-9]*)$/.test(value))
+        return;
+    const parsed = BigInt(value);
+    if (parsed < minimum || parsed > maximum)
+        fail('integer is outside the supported BSON range.');
+}
+/**
+ * Specialized payload checks attached directly to Zod schemas. Wrapper selection and recursion belong to the schema.
+ * This validates the filter's supported EJSON subset without replacing authored values with BSON instances.
+ * EJSON.deserialize alone is not a strict validator: the BSON library can coerce overflowing integers or
+ * normalize malformed base64 instead of rejecting them. Explicit bounds and syntax checks prevent those coercions;
+ * BSON still supplies Decimal128 representability and binary subtype checks where appropriate.
+ * Date strings deliberately retain the library's Date.parse behavior rather than strict calendar validation.
+ * See docs/replication/sync-config-parsing.md for the differences from general Extended JSON.
+ */
+export const MONGO_BSON_VALIDATORS = {
+    mongoNumber: {
+        type: 'number',
+        /**
+         * Plain integer literals have an Int32 interpretation; larger integers must select an EJSON type explicitly.
+         */
+        validate(value) {
+            if (typeof value == 'number' && Number.isInteger(value) && (value < -2_147_483_648 || value > 2_147_483_647)) {
+                fail('integers outside the BSON Int32 range require an EJSON wrapper.');
+            }
+        }
+    },
+    mongoInt32: {
+        type: 'string',
+        /**
+         * Checks a canonical Int32 payload against its signed bounds.
+         * In BSON 6.10.4, EJSON.deserialize({ $numberInt: '2147483648' }, { relaxed: false })
+         * wraps to -2147483648. Default relaxed mode instead returns the out-of-range JS number 2147483648.
+         * Reject the overflow in either case rather than relying on deserialization to validate the bounds.
+         */
+        validate(value) {
+            integerRange(value, -2147483648n, 2147483647n);
+        }
+    },
+    mongoInt64: {
+        type: 'string',
+        /**
+         * Checks a canonical Int64 payload using exact integer arithmetic.
+         * In BSON 6.10.4, EJSON.deserialize({ $numberLong: '9223372036854775808' }, { relaxed: false })
+         * wraps to Long(-9223372036854775808). Default relaxed mode also wraps, then loses precision when
+         * converting to a JS number. Checking with BigInt rejects the overflow before either conversion.
+         */
+        validate(value) {
+            integerRange(value, -9223372036854775808n, 9223372036854775807n);
+        }
+    },
+    mongoDouble: {
+        type: 'string',
+        /**
+         * Rejects overflow to infinity after the schema checks decimal/exponent syntax.
+         */
+        validate(value) {
+            if (!Number.isFinite(Number(value)))
+                fail('expected a finite Extended JSON double string.');
+        }
+    },
+    mongoDecimal128: {
+        type: 'string',
+        /**
+         * Delegates representability to BSON rather than converting through a lossy JavaScript number.
+         */
+        validate(value) {
+            if (typeof value != 'string' || /nan|inf/i.test(value))
+                fail('expected a finite Extended JSON Decimal128 string.');
+            try {
+                Decimal128.fromString(value);
+            }
+            catch {
+                fail('expected a valid Extended JSON Decimal128 string.');
+            }
+        }
+    },
+    mongoDateString: {
+        type: 'string',
+        /**
+         * Requires a finite timestamp after the schema checks the timestamp format and explicit timezone.
+         * BSON's EJSON date-string conversion also uses Date.parse, including its calendar normalization
+         * (for example, 2026-02-29 becomes March 1). This does not enforce strict calendar validity.
+         */
+        validate(value) {
+            if (typeof value != 'string' || !Number.isFinite(Date.parse(value)))
+                fail('expected a valid ISO date string.');
+        }
+    },
+    mongoDateMillis: {
+        type: 'string',
+        /**
+         * BSON dates are restored as JavaScript Date objects and must fit their supported millisecond range.
+         */
+        validate(value) {
+            integerRange(value, -8640000000000000n, 8640000000000000n);
+        }
+    },
+    mongoBinary: {
+        type: 'object',
+        /**
+         * Checks BSON subtype constraints, including UUID byte length, after structural byte-encoding validation.
+         * BSON 6.10.4 accepts { $binary: { base64: 'AQI', subType: '0' } } in both relaxed and typed modes;
+         * re-serialization produces base64 'AQI=' and subtype '00'. The Zod schema rejects missing padding
+         * and one-digit subtypes independently before this check, requiring the canonical spelling we support.
+         */
+        validate(value) {
+            try {
+                EJSON.deserialize({ $binary: value }, { relaxed: false });
+            }
+            catch {
+                fail('the Extended JSON binary value is invalid or unsupported.');
+            }
+        }
+    }
+};
+//# sourceMappingURL=MongoBsonValidators.js.map

package/dist/mongo/MongoBsonValidators.js.map

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

package/dist/mongo/MongoFilterExpression.d.ts

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { YamlError } from '../errors.js';
+import type { JsonObject } from '../json.js';
+import type { SyncConfigSourceLocationResolver, SyncConfigSourcePath } from '../SyncConfigDiagnostics.js';
+/**
+ * Supported filter literals, not a general-purpose EJSON parser. EJSON.deserialize converts BSON wrappers but
+ * does not enforce our expression grammar, reject ordinary object operands, or generate editor schemas.
+ * These declarations also supply paths for YAML diagnostics while keeping authored wrappers in saved plans.
+ * We intentionally exclude other EJSON types and non-finite numbers. Plain integers must fit Int32, date
+ * milliseconds must fit JavaScript Date, and binary subtypes use exactly two hex digits.
+ * $literal is a string-only aggregation-expression escape here, not an EJSON type wrapper.
+ * See docs/replication/sync-config-parsing.md for the supported subset and parser compatibility details.
+ */
+declare const WRAPPERS: {
+    $literal: z.ZodString;
+    $oid: z.ZodString;
+    $numberInt: z.ZodString;
+    $numberLong: z.ZodString;
+    $numberDouble: z.ZodString;
+    $numberDecimal: z.ZodString;
+    $uuid: z.ZodString;
+    $date: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        $numberLong: z.ZodString;
+    }, z.core.$strict>]>;
+    $timestamp: z.ZodObject<{
+        t: z.ZodNumber;
+        i: z.ZodNumber;
+    }, z.core.$strict>;
+    $binary: z.ZodObject<{
+        base64: z.ZodString;
+        subType: z.ZodString;
+    }, z.core.$strict>;
+};
+export declare const MONGO_FILTER_SCHEMA: z.ZodType<MongoFilterExpression, unknown, z.core.$ZodTypeInternals<MongoFilterExpression, unknown>>;
+export declare const MONGO_FILTER_VALIDATOR: z.ZodType<MongoFilterExpression, unknown, z.core.$ZodTypeInternals<MongoFilterExpression, unknown>>;
+export declare const MONGO_FILTER_JSON_SCHEMA_DEFINITIONS: JsonObject;
+/**
+ * Validates authored input without replacing it with Zod's parsed output.
+ *
+ * The base path locates the expression within the config. Validation errors may point inside nested
+ * expression objects or operand arrays, so their relative paths are appended to that base path and
+ * resolved through sourceLocationResolver to highlight the specific key or value in the original source.
+ */
+export declare function parseMongoFilterExpression({ value, basePath, sourceLocationResolver }: {
+    value: unknown;
+    basePath: SyncConfigSourcePath;
+    sourceLocationResolver: SyncConfigSourceLocationResolver;
+}): YamlError[];
+export type MongoFieldPath = `$$doc.${string}`;
+export type MongoExpressionLiteral = boolean | number | string | {
+    [Key in keyof typeof WRAPPERS]: {
+        [Property in Key]: z.output<(typeof WRAPPERS)[Key]>;
+    };
+}[keyof typeof WRAPPERS];
+export type MongoFilterExpression = {
+    $eq: [MongoFieldPath, MongoExpressionLiteral];
+} | {
+    $in: [MongoFieldPath, MongoExpressionLiteral[]];
+} | {
+    $and: MongoFilterExpression[];
+} | {
+    $or: MongoFilterExpression[];
+};
+export type MongoTableFilter = MongoFilterExpression | 'disabled';
+export {};

package/dist/mongo/MongoFilterExpression.js

@@ -0,0 +1,183 @@
+import { z } from 'zod';
+import { YamlError } from '../errors.js';
+import { MONGO_BSON_VALIDATORS } from './MongoBsonValidators.js';
+import { MongoFilterValidationError } from './MongoFilterValidation.js';
+/**
+ * Reuses BSON checks directly, without converting their errors through AJV keywords.
+ */
+function bson(schema, name) {
+    return schema.superRefine((value, context) => {
+        try {
+            MONGO_BSON_VALIDATORS[name].validate(value);
+        }
+        catch (error) {
+            if (!(error instanceof MongoFilterValidationError))
+                throw error;
+            context.addIssue({ code: 'custom', message: error.detail, path: [...error.path] });
+        }
+    });
+}
+const INTEGER = z.string().regex(/^-?(?:0|[1-9][0-9]*)$/);
+const FIELD = z
+    .string({ error: 'Expected a source field such as $$doc.name.' })
+    .regex(/^\$\$doc(?:\.(?![0-9]+(?:\.|$))[^.$][^.]*)+$/, 'Expected a source field such as $$doc.name.');
+const NUMBER = bson(z.number(), 'mongoNumber');
+const STRING = z.string().regex(/^(?!\$)/, 'Use $literal for text starting with $.');
+const DATE_STRING = bson(z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/), 'mongoDateString');
+/**
+ * Supported filter literals, not a general-purpose EJSON parser. EJSON.deserialize converts BSON wrappers but
+ * does not enforce our expression grammar, reject ordinary object operands, or generate editor schemas.
+ * These declarations also supply paths for YAML diagnostics while keeping authored wrappers in saved plans.
+ * We intentionally exclude other EJSON types and non-finite numbers. Plain integers must fit Int32, date
+ * milliseconds must fit JavaScript Date, and binary subtypes use exactly two hex digits.
+ * $literal is a string-only aggregation-expression escape here, not an EJSON type wrapper.
+ * See docs/replication/sync-config-parsing.md for the supported subset and parser compatibility details.
+ */
+const WRAPPERS = {
+    $literal: z.string(),
+    $oid: z.string().regex(/^[0-9a-fA-F]{24}$/),
+    $numberInt: bson(INTEGER, 'mongoInt32'),
+    $numberLong: bson(INTEGER, 'mongoInt64'),
+    $numberDouble: bson(z.string().regex(/^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/), 'mongoDouble'),
+    $numberDecimal: bson(z.string(), 'mongoDecimal128'),
+    $uuid: z.string().regex(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/),
+    $date: z.union([DATE_STRING, z.strictObject({ $numberLong: bson(INTEGER, 'mongoDateMillis') })]),
+    $timestamp: z.strictObject({
+        t: z.number().int().min(0).max(0xffffffff),
+        i: z.number().int().min(0).max(0xffffffff)
+    }),
+    $binary: bson(z.strictObject({
+        base64: z.string().regex(/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/][AQgw]==|[A-Za-z0-9+/]{2}[AEIMQUYcgkosw048]=)?$/),
+        subType: z.string().regex(/^[0-9a-fA-F]{2}$/)
+    }), 'mongoBinary')
+};
+/**
+ * MongoDB comparisons take a field reference and a scalar or list operand.
+ */
+function comparison(value) {
+    return z.tuple([FIELD, value]);
+}
+/**
+ * Defines operand shapes once for the structural schema and runtime validator.
+ * With dispatch=false, explicit unions describe every allowed shape for JSON Schema generation and autocomplete.
+ * With dispatch=true, validation selects the schema for the supplied operator or literal type, avoiding union
+ * errors from unrelated alternatives. This custom selection cannot be represented in generated JSON Schema,
+ * so both schemas share the operand definitions but use different selection logic.
+ */
+function createGrammar({ dispatch }) {
+    const wrappers = keyed(WRAPPERS, dispatch);
+    const literal = dispatch
+        ? z.unknown().superRefine((value, context) => {
+            const schema = typeof value === 'string'
+                ? STRING
+                : typeof value === 'number'
+                    ? NUMBER
+                    : typeof value === 'boolean'
+                        ? z.boolean()
+                        : wrappers;
+            forwardIssues(schema, value, context);
+        })
+        : z.union([z.boolean(), NUMBER, STRING, wrappers]);
+    // Defer resolution so boolean operators can contain nested expressions.
+    const expression = z
+        .lazy(() => keyed(operands, dispatch))
+        .meta(dispatch ? {} : { id: 'mongodb_filter_expression' });
+    const operands = {
+        $eq: comparison(literal).meta({
+            description: 'Compare a source field with a scalar constant.',
+            examples: [['$$doc.status', 'active']]
+        }),
+        $in: comparison(z.array(literal).min(1)).meta({
+            examples: [['$$doc.status', ['pending', 'shipped']]]
+        }),
+        $and: z
+            .array(expression)
+            .min(1)
+            .meta({ examples: [[{ $eq: ['$$doc.active', true] }]] }),
+        $or: z
+            .array(expression)
+            .min(1)
+            .meta({ examples: [[{ $eq: ['$$doc.status', 'pending'] }, { $eq: ['$$doc.priority', true] }]] })
+    };
+    return expression;
+}
+/**
+ * Chooses one named payload schema without trying unrelated alternatives.
+ * Zod tuples and arrays handle operand validation, recursion, and issue paths.
+ */
+function keyed(schemas, dispatch) {
+    if (!dispatch) {
+        return z.union(Object.entries(schemas).map(([key, schema]) => z.strictObject({ [key]: schema })));
+    }
+    return z.unknown().superRefine((value, context) => {
+        if (value === null || typeof value !== 'object' || Array.isArray(value) || Object.keys(value).length !== 1) {
+            context.addIssue({
+                code: 'custom',
+                message: `Expected exactly one supported ${Object.hasOwn(schemas, '$eq') ? 'filter operator' : 'literal wrapper'}.`
+            });
+            return;
+        }
+        const key = Object.keys(value)[0];
+        if (!Object.hasOwn(schemas, key)) {
+            context.addIssue({
+                code: 'custom',
+                path: [key],
+                params: { target: 'key' },
+                message: `Expected one of ${Object.keys(schemas).join(', ')}.`
+            });
+            return;
+        }
+        forwardIssues(schemas[key], value[key], context, [key]);
+    });
+}
+/**
+ * Adds selected-schema issues to the enclosing Zod context, keeping nested paths intact.
+ */
+function forwardIssues(schema, value, context, prefix = []) {
+    const result = schema.safeParse(value);
+    if (!result.success) {
+        for (const issue of result.error.issues) {
+            context.addIssue({ ...issue, path: [...prefix, ...issue.path] });
+        }
+    }
+}
+// Structural alternatives support editor autocomplete; runtime dispatch gives focused errors.
+export const MONGO_FILTER_SCHEMA = createGrammar({ dispatch: false });
+export const MONGO_FILTER_VALIDATOR = createGrammar({ dispatch: true });
+// Export as a child so Zod names recursive references using its metadata ID instead of `#`.
+// These definitions can then be embedded directly in the complete sync config schema.
+export const MONGO_FILTER_JSON_SCHEMA_DEFINITIONS = z.toJSONSchema(z.object({ mongodb_filter_expression: MONGO_FILTER_SCHEMA }), {
+    // Match the draft supported by our default AJV validator.
+    target: 'draft-7',
+    io: 'input',
+    // Share repeated schemas instead of expanding them at every occurrence.
+    reused: 'ref'
+}).definitions;
+/**
+ * Validates authored input without replacing it with Zod's parsed output.
+ *
+ * The base path locates the expression within the config. Validation errors may point inside nested
+ * expression objects or operand arrays, so their relative paths are appended to that base path and
+ * resolved through sourceLocationResolver to highlight the specific key or value in the original source.
+ */
+export function parseMongoFilterExpression({ value, basePath, sourceLocationResolver }) {
+    const result = MONGO_FILTER_VALIDATOR.safeParse(value);
+    const errors = [];
+    for (const issue of result.success ? [] : result.error.issues) {
+        // Extra properties point to their keys; operand failures point to their values.
+        const targets = issue.code === 'unrecognized_keys'
+            ? issue.keys.map((key) => ({ path: [...issue.path, key], target: 'key' }))
+            : [
+                {
+                    path: issue.path,
+                    target: issue.code === 'custom' && issue.params?.target === 'key' ? 'key' : 'value'
+                }
+            ];
+        for (const { path: relativePath, target } of targets) {
+            const path = [...basePath, ...relativePath.map((part) => (typeof part === 'symbol' ? String(part) : part))];
+            errors.push(new YamlError(new Error(`Invalid MongoDB pre-filtering expression: ${issue.message}`), sourceLocationResolver.getLocation(path, target)));
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=MongoFilterExpression.js.map

package/dist/mongo/MongoFilterExpression.js.map

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

package/dist/mongo/MongoFilterValidation.d.ts

@@ -0,0 +1,28 @@
+import type { ErrorLocation } from '../errors.js';
+import type { SyncConfigSourceLocationTarget, SyncConfigSourcePath } from '../SyncConfigDiagnostics.js';
+/**
+ * A path into the authored expression, e.g. `['expression', '$eq', 1, '$oid']`, without configured literal values.
+ */
+export declare class MongoFilterValidationError extends Error {
+    readonly location?: ErrorLocation;
+    readonly detail: string;
+    readonly path: SyncConfigSourcePath;
+    readonly target: SyncConfigSourceLocationTarget;
+    /**
+     * Formats the diagnostic path and retains its key/value target for YAML source highlighting.
+     */
+    constructor({ path, message, target, location }: {
+        path: SyncConfigSourcePath;
+        message: string;
+        target?: SyncConfigSourceLocationTarget;
+        location?: ErrorLocation;
+    });
+}
+/**
+ * Supported single-key Extended JSON wrappers. Payload validation belongs to the individual codecs.
+ */
+export declare const SUPPORTED_EXTENDED_JSON_WRAPPERS: ReadonlySet<string>;
+/**
+ * Authored documents are plain JSON objects; native Date/BSON instances must use their EJSON spelling.
+ */
+export declare function isMongoDocument(value: unknown): value is Record<string, unknown>;

package/dist/mongo/MongoFilterValidation.js

@@ -0,0 +1,47 @@
+/**
+ * A path into the authored expression, e.g. `['expression', '$eq', 1, '$oid']`, without configured literal values.
+ */
+export class MongoFilterValidationError extends Error {
+    location;
+    detail;
+    path;
+    target;
+    /**
+     * Formats the diagnostic path and retains its key/value target for YAML source highlighting.
+     */
+    constructor({ path, message, target = 'value', location }) {
+        const formattedPath = path
+            .map((part, index) => (typeof part == 'number' ? `[${part}]` : `${index ? '.' : ''}${part}`))
+            .join('');
+        super(`Invalid MongoDB pre-filtering expression at '${formattedPath}': ${message}`);
+        this.name = 'MongoFilterValidationError';
+        this.detail = message;
+        this.location = location;
+        this.path = path;
+        this.target = target;
+    }
+}
+/**
+ * Supported single-key Extended JSON wrappers. Payload validation belongs to the individual codecs.
+ */
+export const SUPPORTED_EXTENDED_JSON_WRAPPERS = new Set([
+    '$oid',
+    '$numberInt',
+    '$numberLong',
+    '$numberDouble',
+    '$numberDecimal',
+    '$date',
+    '$timestamp',
+    '$binary',
+    '$uuid'
+]);
+/**
+ * Authored documents are plain JSON objects; native Date/BSON instances must use their EJSON spelling.
+ */
+export function isMongoDocument(value) {
+    if (value == null || typeof value != 'object')
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+//# sourceMappingURL=MongoFilterValidation.js.map

package/dist/mongo/MongoFilterValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MongoFilterValidation.js","sourceRoot":"","sources":["../../src/mongo/MongoFilterValidation.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,QAAQ,CAAiB;IACzB,MAAM,CAAS;IACf,IAAI,CAAuB;IAC3B,MAAM,CAAiC;IAEhD;;OAEG;IACH,YAAY,EACV,IAAI,EACJ,OAAO,EACP,MAAM,GAAG,OAAO,EAChB,QAAQ,EAMT;QACC,MAAM,aAAa,GAAG,IAAI;aACvB,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;aAC5F,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,KAAK,CAAC,gDAAgD,aAAa,MAAM,OAAO,EAAE,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAwB,IAAI,GAAG,CAAC;IAC3E,MAAM;IACN,YAAY;IACZ,aAAa;IACb,eAAe;IACf,gBAAgB;IAChB,OAAO;IACP,YAAY;IACZ,SAAS;IACT,OAAO;CACR,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,IAAI,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAC9D,CAAC"}

package/dist/schema-generators/TsSchemaGenerator.d.ts

@@ -29,6 +29,7 @@ export declare class TsSchemaGenerator extends SchemaGenerator {
     generate(source: SyncConfig, schema: SourceSchema, options?: GenerateSchemaOptions): string;
     private generateTypeExports;
     private generateImports;
+    private importClause;
     private generateTable;
     private generateStreamHelper;
     private generateColumn;

package/dist/schema-generators/TsSchemaGenerator.js

@@ -62,21 +62,27 @@ ${streamsHelper ?? ''}`;
     }
     generateImports(includeSyncStreams) {
         const importStyle = this.options.imports ?? 'auto';
-        const importedNames = ['column', 'Schema', 'Table'];
-        if (includeSyncStreams) {
-            importedNames.push(...['PowerSyncDatabase', 'SyncStream']);
-        }
-        const importStart = `import { ${importedNames.join(', ')} } from`;
+        const importClause = this.importClause(includeSyncStreams);
         if (importStyle == TsSchemaImports.web) {
-            return `${importStart} '@powersync/web';`;
+            return `import { ${importClause} } from '@powersync/web';`;
         }
         else if (importStyle == TsSchemaImports.reactNative) {
-            return `${importStart} '@powersync/react-native';`;
+            return `import { ${importClause} } from '@powersync/react-native';`;
         }
         else {
-            return `${importStart} '@powersync/web';
-// OR: ${importStart} '@powersync/react-native';`;
+            return `import { ${importClause} } from '@powersync/web';
+// OR: import { ${importClause} } from '@powersync/react-native';`;
+        }
+    }
+    importClause(includeSyncStreams) {
+        const importedNames = ['column', 'Schema', 'Table'];
+        if (!includeSyncStreams) {
+            return importedNames.join(', ');
+        }
+        if (this.language == TsSchemaLanguage.ts) {
+            return `${importedNames.join(', ')}, type PowerSyncDatabase, type SyncStream`;
         }
+        return `${importedNames.join(', ')}, PowerSyncDatabase, SyncStream`;
     }
     generateTable(name, columns, options) {
         const generated = columns.map((c, i) => {

package/dist/schema-generators/TsSchemaGenerator.js.map

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

package/dist/sync_plan/plan.d.ts

@@ -1,5 +1,6 @@
 import { BucketPriority } from '../BucketDescription.js';
 import { ParameterLookupDefinitionId } from '../HydrationState.js';
+import type { SourceTableConfigMap } from '../SourceTableConfig.js';
 import { ImplicitSchemaTablePattern } from '../TablePattern.js';
 import { SqlExpression } from './expression.js';
 /**
@@ -20,6 +21,7 @@ import { SqlExpression } from './expression.js';
  * but we must never alter the semantics for existing serialized plans.
  */
 export interface SyncPlan {
+    sourceTableConfig?: SourceTableConfigMap;
     dataSources: StreamDataSource[];
     buckets: StreamBucketDataSource[];
     parameterIndexes: StreamParameterIndexLookupCreator[];