@semics-tech/mongolite 1.2.0 → 1.4.0

package/dist/sync/mongoExecutor.js

@@ -0,0 +1,302 @@
+/**
+ * Applies prepared write commands to MongoDB and classifies the outcome.
+ *
+ * Shared by the direct sink and by the HTTP receiver, so the subtle part has exactly
+ * one implementation: **a lost compare-and-swap raises no error.** It is a silent
+ * zero-match in an aggregate count, which means detecting it takes deliberate work —
+ * comparing what the batch expected to change against what the server says changed, and
+ * then re-reading the candidates to find out which document actually lost.
+ */
+import { isConditional, isReservedPath, readVersion, stripReservedFields, toUpstreamId, } from './commands.js';
+import { deepEqual } from './diff.js';
+/**
+ * MongoDB server error codes that mean "this write will never succeed" — retrying them
+ * would stall the stream behind one bad document forever, so they are dead-lettered.
+ */
+const PERMANENT_ERROR_CODES = new Set([
+    2, // BadValue
+    9, // FailedToParse
+    10334, // BSONObjectTooLarge
+    14, // TypeMismatch
+    52, // DollarPrefixedFieldName
+    56, // EmptyFieldName
+    121, // DocumentValidationFailure
+    17280, // KeyTooLong
+]);
+/** MongoDB's duplicate-key code. On an insert-if-absent it means we lost a create race. */
+const DUPLICATE_KEY = 11000;
+/**
+ * Runs prepared writes against a database, one `bulkWrite` per collection.
+ *
+ * Throws on transient failure (network, election, timeout) so the caller retries the
+ * whole batch without checkpointing. Returns per-operation failures and conflicts for
+ * everything it could classify.
+ */
+export async function executeWrites(db, writes, options = {}) {
+    const { writeConcern = { w: 'majority' }, versioning = true, idMapping, ObjectId } = options;
+    const byCollection = new Map();
+    for (const write of writes) {
+        const bucket = byCollection.get(write.op.collection);
+        if (bucket)
+            bucket.push(write);
+        else
+            byCollection.set(write.op.collection, [write]);
+    }
+    const failures = [];
+    const conflicts = [];
+    let applied = 0;
+    for (const [collectionName, entries] of byCollection) {
+        let result = null;
+        let rejected = 0;
+        try {
+            result = await db.collection(collectionName).bulkWrite(entries.map((entry) => entry.command), {
+                // Operations within a batch touch distinct documents, so ordering buys
+                // nothing and unordered lets the server parallelise.
+                ordered: false,
+                writeConcern,
+            });
+        }
+        catch (err) {
+            const bulkFailures = classifyBulkError(err, entries.length);
+            // A transient failure means the whole batch's fate is unknown — throw so the
+            // caller retries it rather than checkpointing work that may not have landed.
+            if (bulkFailures === null)
+                throw err;
+            for (const failure of bulkFailures) {
+                const entry = entries[failure.index];
+                if (!entry)
+                    continue;
+                // A duplicate `_id` on an insert-if-absent means someone created the document
+                // first — a conflict to reconcile, not a poison document. A duplicate on any
+                // *other* unique index is a real constraint violation and must be dead-lettered,
+                // or it would be retried forever as a phantom conflict.
+                if (failure.code === DUPLICATE_KEY && isIdIndexViolation(failure)) {
+                    conflicts.push({ index: entry.index, reason: 'already-exists' });
+                }
+                else {
+                    failures.push({ index: entry.index, message: failure.message, code: failure.code });
+                }
+            }
+            rejected = bulkFailures.length;
+            result = err.result ?? null;
+        }
+        const landed = entries.length - rejected;
+        const suspects = findMisses(entries, result, rejected, versioning);
+        // `suspects` are candidates to investigate, not confirmed misses: the counts are
+        // aggregate, so one short count implicates every conditional write in the batch.
+        // Only the re-read says which of them actually lost, and `applied` must be reduced
+        // by that number rather than by the number investigated.
+        const confirmed = suspects.length
+            ? await describeConflicts(db, collectionName, suspects, conflicts, idMapping, ObjectId)
+            : 0;
+        applied += landed - confirmed;
+    }
+    return {
+        applied,
+        failures: failures.length > 0 ? failures : undefined,
+        conflicts: conflicts.length > 0 ? conflicts : undefined,
+    };
+}
+/**
+ * Identifies operations whose conditional write may not have matched.
+ *
+ * `bulkWrite` reports only aggregate counts, so this compares what the batch expected
+ * to change against what the server says changed. When the numbers agree, nothing was
+ * missed and no per-document work is needed.
+ */
+function findMisses(entries, result, rejected, versioning) {
+    if (!versioning || result === null || rejected === entries.length)
+        return [];
+    const candidates = entries.filter((entry) => isConditional(entry.op));
+    if (candidates.length === 0)
+        return [];
+    const writes = candidates.filter((entry) => entry.op.type !== 'delete');
+    const deletes = candidates.filter((entry) => entry.op.type === 'delete');
+    const acknowledgedWrites = (result.matchedCount ?? 0) + (result.upsertedCount ?? 0);
+    const acknowledgedDeletes = result.deletedCount ?? 0;
+    const missed = [];
+    // The counts are aggregate, so which specific documents missed is unknown; the
+    // caller re-reads the candidates and decides per document.
+    if (acknowledgedWrites < writes.length)
+        missed.push(...writes);
+    if (acknowledgedDeletes < deletes.length)
+        missed.push(...deletes);
+    return missed;
+}
+/**
+ * Re-reads the upstream state of operations that may have missed, and records a
+ * conflict for each one whose version really has moved on.
+ *
+ * The re-read turns an aggregate "something didn't match" into a precise, per-document
+ * answer, and supplies the current server document the caller needs to reconcile.
+ *
+ * @returns How many candidates genuinely lost.
+ */
+async function describeConflicts(db, collectionName, candidates, conflicts, idMapping, ObjectId) {
+    const ids = candidates.map((entry) => toUpstreamId(entry.op.documentId, idMapping, ObjectId));
+    const current = await db
+        .collection(collectionName)
+        .find({ _id: { $in: ids } })
+        .toArray();
+    const byId = new Map(current.map((doc) => [String(doc._id), doc]));
+    let confirmed = 0;
+    for (const { index, op } of candidates) {
+        const serverDocument = byId.get(op.documentId);
+        const serverVersion = readVersion(serverDocument);
+        if (op.type === 'delete') {
+            // Already gone upstream is the outcome we wanted, however it happened.
+            if (!serverDocument)
+                continue;
+            conflicts.push({ index, reason: 'version-mismatch', serverDocument, serverVersion });
+            confirmed += 1;
+            continue;
+        }
+        if (!serverDocument) {
+            conflicts.push({ index, reason: 'missing' });
+            confirmed += 1;
+            continue;
+        }
+        // The write may have landed after all, with a different operation in the batch
+        // being the one that missed.
+        //
+        // A version one ahead is necessary evidence but nowhere near sufficient: another
+        // writer following the same protocol also bumps `_v` by exactly one, so the two
+        // cases look identical from the version alone. Confirming that the document
+        // actually carries our change is what tells them apart — and getting this wrong
+        // silently swallows the very conflicts this machinery exists to catch.
+        if (isConditional(op) &&
+            serverVersion === op.baseVersion + 1 &&
+            reflectsWrite(serverDocument, op)) {
+            continue;
+        }
+        conflicts.push({ index, reason: 'version-mismatch', serverDocument, serverVersion });
+        confirmed += 1;
+    }
+    return confirmed;
+}
+/**
+ * Splits a driver error into per-operation permanent failures.
+ *
+ * @returns The failures to dead-letter, or `null` when the error is transient and the
+ * whole batch should be retried.
+ */
+export function classifyBulkError(err, operationCount) {
+    const error = err;
+    // The driver retried and still could not reach a writable primary.
+    if (error.hasErrorLabel?.('RetryableWriteError'))
+        return null;
+    const writeErrors = error.writeErrors ?? error.result?.writeErrors;
+    if (Array.isArray(writeErrors) && writeErrors.length > 0) {
+        const failures = [];
+        for (const writeError of writeErrors) {
+            const code = writeError.code;
+            // An unrecognised write error might be transient (a duplicate key during a
+            // failover, say), so the batch is worth retrying whole. A duplicate key is
+            // handled separately by the caller, as a create race rather than a defect.
+            if (code === undefined || (code !== DUPLICATE_KEY && !PERMANENT_ERROR_CODES.has(code))) {
+                return null;
+            }
+            const index = writeError.index ?? 0;
+            if (index >= operationCount)
+                return null;
+            failures.push({
+                index,
+                message: writeError.errmsg ?? writeError.message ?? `write error ${code}`,
+                code,
+                keyPattern: writeError.keyPattern,
+            });
+        }
+        return failures;
+    }
+    // No per-write detail: a connection, timeout or auth error. Retry it.
+    return null;
+}
+/**
+ * True when the upstream document carries the change this operation was making.
+ *
+ * Only the paths the operation itself wrote are checked. That is deliberate: those are
+ * the values we would have written in local JSON form, so comparing them against the
+ * server is meaningful, whereas fields we never touched may hold BSON types the local
+ * store cannot represent and would not compare equal.
+ *
+ * A false positive is possible if another writer happened to set the identical value —
+ * and is harmless, since the upstream then holds what we wanted anyway.
+ */
+function reflectsWrite(serverDocument, op) {
+    if (op.diff) {
+        for (const [path, value] of Object.entries(op.diff.set)) {
+            if (isReservedPath(path))
+                continue;
+            if (!valueAtPathEquals(serverDocument, path, value))
+                return false;
+        }
+        for (const path of op.diff.unset) {
+            if (isReservedPath(path))
+                continue;
+            if (readPath(serverDocument, path) !== undefined)
+                return false;
+        }
+        return true;
+    }
+    // Whole-document write: every field we sent should be present upstream.
+    for (const [key, value] of Object.entries(stripReservedFields(op.document ?? {}))) {
+        if (!valueAtPathEquals(serverDocument, key, value))
+            return false;
+    }
+    return true;
+}
+/**
+ * Compares a value at a dotted path against what we wrote.
+ *
+ * The server side is flattened to local JSON shape first, so a `Date` upstream compares
+ * equal to the ISO string a local write would have carried.
+ */
+function valueAtPathEquals(document, path, expected) {
+    const actual = readPath(document, path);
+    if (actual === undefined)
+        return false;
+    try {
+        return deepEqual(JSON.parse(JSON.stringify(actual)), expected);
+    }
+    catch {
+        return false;
+    }
+}
+/** Reads a dotted path, returning `undefined` if any segment is missing. */
+function readPath(document, path) {
+    let current = document;
+    for (const segment of path.split('.')) {
+        if (typeof current !== 'object' || current === null)
+            return undefined;
+        current = current[segment];
+        if (current === undefined)
+            return undefined;
+    }
+    return current;
+}
+/**
+ * True when a duplicate-key error is about the `_id` index specifically.
+ *
+ * MongoDB reports the offending index in `keyPattern` (and names it in `errmsg`), which
+ * is the only way to tell "someone else created this document" apart from "this document
+ * violates a unique constraint on some other field".
+ */
+function isIdIndexViolation(failure) {
+    if (failure.keyPattern) {
+        const keys = Object.keys(failure.keyPattern);
+        return keys.length === 1 && keys[0] === '_id';
+    }
+    // Older servers and some drivers only give the message; the index name appears in it.
+    return /index:\s*_id_/.test(failure.message);
+}
+/** Reads documents back by `_id`, for refreshing a shadow after a conflict. */
+export async function fetchDocuments(db, collection, documentIds, idMapping, ObjectId) {
+    if (documentIds.length === 0)
+        return [];
+    const ids = documentIds.map((id) => toUpstreamId(id, idMapping, ObjectId));
+    return db
+        .collection(collection)
+        .find({ _id: { $in: ids } })
+        .toArray();
+}
+//# sourceMappingURL=mongoExecutor.js.map

package/dist/sync/mongoExecutor.js.map

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

package/dist/sync/mongoSink.d.ts

@@ -0,0 +1,109 @@
+/**
+ * A {@link SyncSink} that writes to a MongoDB deployment using the official
+ * `mongodb` driver.
+ *
+ * The driver is an **optional peer dependency**, imported dynamically the first
+ * time a connection is opened. Projects that never replicate upstream do not
+ * need it installed, and bundlers that never reach this module do not pull it in.
+ */
+import type { MongoDriverLike, SyncApplyResult, SyncIdMapping, SyncOperation, SyncSink } from './types.js';
+export { VERSION_FIELD, UPDATED_AT_FIELD } from './commands.js';
+/**
+ * Authentication and transport settings for the upstream connection.
+ *
+ * Most deployments need nothing beyond the connection string — it already
+ * carries username, password, `authSource`, `replicaSet` and `tls`. These
+ * options cover the cases a URI cannot express, chiefly the certificate-file
+ * based mechanisms (X.509, mTLS, a private CA).
+ */
+export interface MongoUpstreamAuth {
+    /** Database to authenticate against, when it differs from the target database. */
+    authSource?: string;
+    /**
+     * SASL/auth mechanism, e.g. `'SCRAM-SHA-256'`, `'MONGODB-X509'`,
+     * `'MONGODB-AWS'`, `'MONGODB-OIDC'`, `'GSSAPI'`, `'PLAIN'`.
+     * Omit to let the driver negotiate.
+     */
+    authMechanism?: string;
+    /** Mechanism-specific properties, e.g. `{ AWS_SESSION_TOKEN: '…' }`. */
+    authMechanismProperties?: Record<string, unknown>;
+    /** Username, when not embedded in the connection string. */
+    username?: string;
+    /** Password, when not embedded in the connection string. */
+    password?: string;
+    /** Force TLS on or off. Usually inferred from the connection string. */
+    tls?: boolean;
+    /** Path to a PEM file with the certificate authority chain, for a private CA. */
+    tlsCAFile?: string;
+    /**
+     * Path to a PEM file holding the client certificate **and** its private key —
+     * required for mutual TLS and for `MONGODB-X509` authentication.
+     */
+    tlsCertificateKeyFile?: string;
+    /** Passphrase for an encrypted `tlsCertificateKeyFile`. */
+    tlsCertificateKeyFilePassword?: string;
+    /** Path to a PEM file listing revoked certificates. */
+    tlsCRLFile?: string;
+    /**
+     * Skip hostname verification. Never enable this against a production
+     * deployment — it removes the protection TLS is there to provide.
+     */
+    tlsAllowInvalidHostnames?: boolean;
+    /**
+     * Accept certificates that fail validation. Never enable this against a
+     * production deployment.
+     */
+    tlsAllowInvalidCertificates?: boolean;
+}
+export interface MongoSinkOptions extends MongoUpstreamAuth {
+    /** Upstream connection string, e.g. `mongodb+srv://host/db`. */
+    connectionString: string;
+    /** Target database. Defaults to the one in the connection string's path. */
+    database?: string;
+    /** See {@link SyncIdMapping}. Defaults to `'auto'`. */
+    idMapping?: SyncIdMapping;
+    /**
+     * Guard writes with a conditional update against each document's last-known `_v`.
+     * Defaults to `true`. See {@link SyncOptions.versioning}.
+     */
+    versioning?: boolean;
+    /**
+     * Write concern for replicated batches. Defaults to `{ w: 'majority' }` so an
+     * acknowledged batch has actually survived upstream before it is checkpointed
+     * locally.
+     */
+    writeConcern?: Record<string, unknown>;
+    /**
+     * Extra options passed straight through to `new MongoClient(...)`. Anything
+     * the driver supports — `serverApi`, `proxyHost`, `compressors`,
+     * `autoEncryption`, connection-pool tuning — belongs here.
+     */
+    driverOptions?: Record<string, unknown>;
+    /**
+     * Supply the `mongodb` module yourself instead of having it imported
+     * dynamically. Useful for bundlers that cannot resolve dynamic imports, and
+     * for tests.
+     */
+    driver?: MongoDriverLike;
+}
+export declare class MongoUpstreamSink implements SyncSink {
+    private readonly options;
+    readonly name = "mongodb";
+    private client;
+    private db;
+    private driver;
+    private readonly idMapping;
+    private readonly versioning;
+    constructor(options: MongoSinkOptions);
+    connect(): Promise<void>;
+    apply(operations: SyncOperation[]): Promise<SyncApplyResult>;
+    /**
+     * Command-building settings. The driver's own `ObjectId` is used when available so
+     * BSON instances match the connection that will serialise them.
+     */
+    private commandOptions;
+    fetch(collection: string, documentIds: string[]): Promise<Record<string, unknown>[]>;
+    close(): Promise<void>;
+    private loadDriver;
+    private clientOptions;
+}

package/dist/sync/mongoSink.js

@@ -0,0 +1,123 @@
+/**
+ * A {@link SyncSink} that writes to a MongoDB deployment using the official
+ * `mongodb` driver.
+ *
+ * The driver is an **optional peer dependency**, imported dynamically the first
+ * time a connection is opened. Projects that never replicate upstream do not
+ * need it installed, and bundlers that never reach this module do not pull it in.
+ */
+import { buildWriteCommand } from './commands.js';
+import { executeWrites, fetchDocuments } from './mongoExecutor.js';
+export { VERSION_FIELD, UPDATED_AT_FIELD } from './commands.js';
+export class MongoUpstreamSink {
+    constructor(options) {
+        this.options = options;
+        this.name = 'mongodb';
+        this.client = null;
+        this.db = null;
+        this.driver = null;
+        if (!options.connectionString) {
+            throw new Error('MongoUpstreamSink requires a `connectionString`.');
+        }
+        this.idMapping = options.idMapping ?? 'auto';
+        this.versioning = options.versioning ?? true;
+        this.driver = options.driver ?? null;
+    }
+    async connect() {
+        if (this.client && this.db)
+            return;
+        const driver = await this.loadDriver();
+        const client = new driver.MongoClient(this.options.connectionString, this.clientOptions());
+        await client.connect();
+        this.client = client;
+        this.db = client.db(this.options.database);
+    }
+    async apply(operations) {
+        if (!this.db)
+            await this.connect();
+        const db = this.db;
+        if (!db)
+            throw new Error('MongoUpstreamSink is not connected.');
+        const writes = operations.map((op, index) => ({
+            index,
+            op,
+            command: buildWriteCommand(op, this.commandOptions()),
+        }));
+        return executeWrites(db, writes, {
+            writeConcern: this.options.writeConcern ?? { w: 'majority' },
+            versioning: this.versioning,
+            idMapping: this.idMapping,
+            ObjectId: this.driver?.ObjectId,
+        });
+    }
+    /**
+     * Command-building settings. The driver's own `ObjectId` is used when available so
+     * BSON instances match the connection that will serialise them.
+     */
+    commandOptions() {
+        return {
+            idMapping: this.idMapping,
+            versioning: this.versioning,
+            ObjectId: this.driver?.ObjectId,
+        };
+    }
+    async fetch(collection, documentIds) {
+        if (documentIds.length === 0)
+            return [];
+        if (!this.db)
+            await this.connect();
+        const db = this.db;
+        if (!db)
+            throw new Error('MongoUpstreamSink is not connected.');
+        return fetchDocuments(db, collection, documentIds, this.idMapping, this.driver?.ObjectId);
+    }
+    async close() {
+        const client = this.client;
+        this.client = null;
+        this.db = null;
+        if (client)
+            await client.close();
+    }
+    // ---------------------------------------------------------------- internals
+    async loadDriver() {
+        if (this.driver)
+            return this.driver;
+        try {
+            // Indirect specifier: `mongodb` is optional, and a literal import would
+            // make it a hard build-time dependency for everyone compiling this package.
+            const specifier = 'mongodb';
+            const mod = (await import(specifier));
+            this.driver = mod;
+            return mod;
+        }
+        catch (err) {
+            throw new Error('MongoDB sync requires the `mongodb` driver. Install it with `npm install mongodb`, ' +
+                `or pass a \`driver\` explicitly. Original error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    clientOptions() {
+        const { authSource, authMechanism, authMechanismProperties, username, password, tls, tlsCAFile, tlsCertificateKeyFile, tlsCertificateKeyFilePassword, tlsCRLFile, tlsAllowInvalidHostnames, tlsAllowInvalidCertificates, driverOptions, } = this.options;
+        const auth = username !== undefined || password !== undefined ? { username, password } : undefined;
+        // Undefined keys are stripped so they never override a setting that the
+        // connection string already specified.
+        return stripUndefined({
+            authSource,
+            authMechanism,
+            authMechanismProperties,
+            auth,
+            tls,
+            tlsCAFile,
+            tlsCertificateKeyFile,
+            tlsCertificateKeyFilePassword,
+            tlsCRLFile,
+            tlsAllowInvalidHostnames,
+            tlsAllowInvalidCertificates,
+            ...driverOptions,
+        });
+    }
+}
+/** Drops unset keys so they never override what the connection string specified. */
+function stripUndefined(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, v]) => v !== undefined));
+}
+//# sourceMappingURL=mongoSink.js.map

package/dist/sync/mongoSink.js.map

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