@lossless.org/client 1.22.2 → 1.23.1

package/dist_ts/nosqldb/classes.writelog.js

@@ -0,0 +1,497 @@
+import * as plugins from './plugins.js';
+import { assertDataOptions } from './classes.operationbudget.js';
+import { SmartdataPersistenceError } from './classes.persistence.js';
+import { narrowSmartdataWriteReport, normalizeObservedFields, reportOfSmartdataWrite, } from './classes.writeobserver.js';
+import { isSmartdataWriteRevisionsActive, writeRevisionsCollectionName } from './classes.writerevisions.js';
+import { smartdataCommitJournal } from './engineidentity.js';
+import { logger } from './logging.js';
+/** The collection that holds the entries. */
+export const writeLogCollectionName = '__smartdata_write_log';
+/** How long an entry is kept. The engine keeps a commit in its journal at most as long. */
+export const writeLogRetentionSeconds = 15 * 60;
+const expiryIndexName = 'smartdata_write_log_expiry';
+const activePollMs = 250;
+const idlePollMs = 1_000;
+/** A follower that saw a commit this recently polls at the active pace. */
+const activeWindowMs = 60_000;
+const pageLimit = 128;
+/** The engine's largest page; a single commit record larger than a page is refused. */
+const pageBytes = 4 * 1024 * 1024;
+const readTimeoutMs = 5_000;
+/** Beyond these bounds, an entry states its largest collections as unplaced instead. */
+const maximumEntryDocuments = 4_096;
+const maximumEntryBytes = 1024 * 1024;
+/** How long a follower remembers a local delivery whose commit the journal has not listed yet. */
+const localDeliveryMemoryMs = 2 * writeLogRetentionSeconds * 1_000;
+/**
+ * Namespaces whose changes only carry the bookkeeping of model writes, and the
+ * database's own namespace, which a catalog change publishes beside the
+ * collection it changed.
+ */
+const bookkeepingCollections = new Set([
+    '',
+    writeLogCollectionName,
+    writeRevisionsCollectionName,
+]);
+const writeKinds = new Set(['insert', 'update', 'replace', 'delete']);
+const logFields = new WeakMap();
+const logStates = new WeakMap();
+const stateOf = (dbArg) => {
+    let state = logStates.get(dbArg);
+    if (!state) {
+        state = { followers: new Set(), pending: new Map() };
+        logStates.set(dbArg, state);
+    }
+    return state;
+};
+/** @internal Validates and records the option; called once by the database's constructor. */
+export const configureSmartdataWriteLog = (dbArg, optionsArg) => {
+    if (optionsArg === undefined)
+        return;
+    const { fields } = assertDataOptions(optionsArg, ['fields']);
+    logFields.set(dbArg, normalizeObservedFields(fields, 'A SmartData write log'));
+};
+/**
+ * @internal The write log is configured and the engine journals its commits
+ * in commit order; elsewhere the option is inert.
+ */
+export const isSmartdataWriteLogActive = (dbArg) => logFields.has(dbArg)
+    && dbArg.capabilities?.transactions === 'available'
+    && smartdataCommitJournal(dbArg.engineIdentity);
+/**
+ * @internal Every model write runs in an owned transaction, which carries its
+ * write revisions and its write-log entry.
+ */
+export const requiresSmartdataWriteTransactions = (dbArg) => isSmartdataWriteRevisionsActive(dbArg) || isSmartdataWriteLogActive(dbArg);
+/** @internal The report a write adds to its transaction's entry, or `undefined` without an active log. */
+export const writeLogReportOf = (dbArg, writeArg) => {
+    const fields = logFields.get(dbArg);
+    return fields !== undefined && isSmartdataWriteLogActive(dbArg)
+        ? reportOfSmartdataWrite(writeArg, fields)
+        : undefined;
+};
+const logCollection = (mongoDbArg) => mongoDbArg.collection(writeLogCollectionName);
+/**
+ * @internal Creates the index that expires entries, before `init()` publishes
+ * the connection. Another process creating it at the same time is fine.
+ */
+export const ensureSmartdataWriteLog = async (mongoDbArg, optionsArg = {}) => {
+    await logCollection(mongoDbArg).createIndex({ at: 1 }, {
+        name: expiryIndexName,
+        expireAfterSeconds: writeLogRetentionSeconds,
+        ...optionsArg,
+    });
+};
+/**
+ * The receipt the engine journals a transaction's commit with. The driver
+ * numbers a transaction when it sends the transaction's first command.
+ */
+const receiptOfSession = (rawSessionArg) => {
+    const id = rawSessionArg.id;
+    if (id === undefined) {
+        throw new SmartdataPersistenceError('unsupported_operation', 'A SmartData transaction has no server session to key its write-log entry by.');
+    }
+    return `${id.id.toUUID().toHexString()}:${rawSessionArg.serverSession.txnNumber}`;
+};
+const receiptOfJournal = (sessionArg, transactionArg) => `${sessionArg}:${transactionArg}`;
+/**
+ * The entry as written: a collection whose writes cannot be placed changed as
+ * a whole, so its reports add nothing, and the largest collections become
+ * unplaced until the entry fits its bounds.
+ */
+const boundWriteLogEntry = (reportsArg, unplacedArg) => {
+    const unplaced = new Set(unplacedArg);
+    const sizes = new Map();
+    let documents = 0;
+    let bytes = plugins.mongodb.BSON.calculateObjectSize({ unplaced: [...unplaced] });
+    for (const report of reportsArg) {
+        if (unplaced.has(report.collection))
+            continue;
+        const size = sizes.get(report.collection) ?? { documents: 0, bytes: 0 };
+        const reportDocuments = report.documents?.length ?? 0;
+        const reportBytes = plugins.mongodb.BSON.calculateObjectSize(report);
+        size.documents += reportDocuments;
+        size.bytes += reportBytes;
+        documents += reportDocuments;
+        bytes += reportBytes;
+        sizes.set(report.collection, size);
+    }
+    const bySize = [...sizes].sort(([, aArg], [, bArg]) => bArg.bytes - aArg.bytes);
+    for (const [collection, size] of bySize) {
+        if (documents <= maximumEntryDocuments && bytes <= maximumEntryBytes)
+            break;
+        unplaced.add(collection);
+        documents -= size.documents;
+        bytes -= size.bytes;
+    }
+    return Object.freeze({
+        reports: Object.freeze(reportsArg.filter((reportArg) => !unplaced.has(reportArg.collection))),
+        unplaced: Object.freeze([...unplaced].sort()),
+    });
+};
+/**
+ * @internal Writes a transaction's entry inside that transaction, right
+ * before its commit, and registers it until its outcome settled. `undefined`
+ * when the transaction wrote nothing through the models.
+ */
+export const flushSmartdataWriteLog = async (dbArg, mongoDbArg, rawSessionArg, reportsArg, unplacedArg, signalArg) => {
+    const fields = logFields.get(dbArg);
+    if (fields === undefined || (reportsArg.length === 0 && unplacedArg.size === 0))
+        return undefined;
+    const collection = logCollection(mongoDbArg);
+    const signalOptions = signalArg === undefined ? {} : { signal: signalArg };
+    if (reportsArg.length === 0) {
+        // No write of the attempt was acknowledged, so none may have numbered the transaction yet.
+        await collection.findOne({ _id: '' }, { projection: { _id: 1 }, session: rawSessionArg, ...signalOptions });
+    }
+    const receipt = receiptOfSession(rawSessionArg);
+    const entry = boundWriteLogEntry(reportsArg, unplacedArg);
+    await collection.insertOne({
+        _id: receipt,
+        at: new Date(),
+        fields: [...fields],
+        reports: [...entry.reports],
+        unplaced: [...entry.unplaced],
+    }, { session: rawSessionArg, ...signalOptions });
+    const { pending } = stateOf(dbArg);
+    const settled = Promise.withResolvers();
+    pending.set(receipt, settled.promise);
+    let open = true;
+    return {
+        receipt,
+        entry,
+        settle: () => {
+            if (!open)
+                return;
+            open = false;
+            if (pending.get(receipt) === settled.promise)
+                pending.delete(receipt);
+            settled.resolve();
+        },
+    };
+};
+/**
+ * @internal Delivers a confirmed commit of this database instance to its
+ * followers at once; each then skips the commit when the journal lists it.
+ */
+export const deliverSmartdataWriteLogCommit = (dbArg, commitArg) => {
+    const followers = logStates.get(dbArg)?.followers;
+    if (!followers)
+        return;
+    for (const follower of [...followers]) {
+        follower.deliverLocal(commitArg);
+    }
+};
+const isPlainRecord = (valueArg) => {
+    if (typeof valueArg !== 'object' || valueArg === null || Array.isArray(valueArg))
+        return false;
+    const prototype = Object.getPrototypeOf(valueArg);
+    return prototype === Object.prototype || prototype === null;
+};
+const unexpectedPage = () => new SmartdataPersistenceError('unsupported_operation', 'The engine answered getCommittedWrites with an unexpected page.');
+const unsignedDecimal = /^(?:0|[1-9][0-9]*)$/;
+const stampOf = (valueArg) => {
+    if (!isPlainRecord(valueArg)
+        || typeof valueArg.timeline !== 'string'
+        || typeof valueArg.sequence !== 'string'
+        || !unsignedDecimal.test(valueArg.sequence)) {
+        throw unexpectedPage();
+    }
+    return Object.freeze({ timeline: valueArg.timeline, sequence: valueArg.sequence });
+};
+const committedWriteOf = (valueArg, databaseArg) => {
+    if (!isPlainRecord(valueArg) || !Array.isArray(valueArg.namespaces) || typeof valueArg.committedAtMs !== 'number') {
+        throw unexpectedPage();
+    }
+    const collections = new Set();
+    let logged = false;
+    for (const namespace of valueArg.namespaces) {
+        if (!isPlainRecord(namespace) || typeof namespace.database !== 'string' || typeof namespace.collection !== 'string') {
+            throw unexpectedPage();
+        }
+        if (namespace.database !== databaseArg)
+            continue;
+        if (namespace.collection === writeLogCollectionName)
+            logged = true;
+        if (!bookkeepingCollections.has(namespace.collection))
+            collections.add(namespace.collection);
+    }
+    const receipt = valueArg.receipt;
+    if (receipt !== null && receipt !== undefined && (!isPlainRecord(receipt) || typeof receipt.session !== 'string' || typeof receipt.transaction !== 'string')) {
+        throw unexpectedPage();
+    }
+    return {
+        stamp: stampOf(valueArg.stamp),
+        committedAtMs: valueArg.committedAtMs,
+        collections: [...collections].sort(),
+        // A retryable statement outside a transaction carries its number; only a
+        // transaction can have written an entry.
+        receipt: isPlainRecord(receipt) && (receipt.statement === null || receipt.statement === undefined)
+            ? receiptOfJournal(receipt.session, receipt.transaction)
+            : undefined,
+        logged,
+    };
+};
+/** One page of the database's commit journal after `afterArg`, or its head without `afterArg`. */
+const readCommittedWrites = async (mongoDbArg, afterArg, signalArg) => {
+    const page = await mongoDbArg.command({
+        getCommittedWrites: 1,
+        ...(afterArg === undefined ? {} : { after: { timeline: afterArg.timeline, sequence: afterArg.sequence } }),
+        limit: pageLimit,
+        maximumBytes: pageBytes,
+    }, { timeoutMS: readTimeoutMs, ...(signalArg === undefined ? {} : { signal: signalArg }) });
+    if (!Array.isArray(page.writes) || typeof page.gap !== 'boolean' || typeof page.hasMore !== 'boolean') {
+        throw unexpectedPage();
+    }
+    return {
+        writes: page.writes.map((writeArg) => committedWriteOf(writeArg, mongoDbArg.databaseName)),
+        cursor: stampOf(page.cursor),
+        head: stampOf(page.head),
+        gap: page.gap,
+        hasMore: page.hasMore,
+    };
+};
+/**
+ * The entry a stored document states for a follower of `fieldsArg`, or
+ * `undefined` when it states none: a document another version wrote or one
+ * that does not record every field followed.
+ */
+const entryOfDocument = (documentArg, fieldsArg) => {
+    if (!isPlainRecord(documentArg))
+        return undefined;
+    const { fields, reports, unplaced } = documentArg;
+    if (!Array.isArray(fields)
+        || !fieldsArg.every((fieldArg) => fields.includes(fieldArg))
+        || !Array.isArray(unplaced)
+        || !unplaced.every((collectionArg) => typeof collectionArg === 'string')
+        || !Array.isArray(reports)
+        || !reports.every((reportArg) => isPlainRecord(reportArg)
+            && typeof reportArg.collection === 'string'
+            && writeKinds.has(reportArg.kind)
+            && isPlainRecord(reportArg.anchors)
+            && (reportArg.documents === null
+                || (Array.isArray(reportArg.documents) && reportArg.documents.every(isPlainRecord))))) {
+        return undefined;
+    }
+    return { reports: reports, unplaced: unplaced };
+};
+const describeError = (errorArg) => errorArg instanceof Error ? errorArg.message : String(errorArg);
+/** Resolves after `millisecondsArg`, or at once when `signalArg` aborts. */
+const pause = (millisecondsArg, signalArg) => new Promise((resolveArg) => {
+    if (signalArg.aborted)
+        return resolveArg();
+    const done = () => {
+        clearTimeout(timer);
+        signalArg.removeEventListener('abort', done);
+        resolveArg();
+    };
+    const timer = setTimeout(done, millisecondsArg);
+    signalArg.addEventListener('abort', done, { once: true });
+});
+/** Resolves when `promiseArg` settles, or at once when `signalArg` aborts. */
+const settledOrAborted = (promiseArg, signalArg) => new Promise((resolveArg) => {
+    if (signalArg.aborted)
+        return resolveArg();
+    const done = () => {
+        signalArg.removeEventListener('abort', done);
+        resolveArg();
+    };
+    signalArg.addEventListener('abort', done, { once: true });
+    void promiseArg.finally(done);
+});
+class SmartdataWriteFollower {
+    state;
+    fields;
+    onWrite;
+    onGap;
+    /** The receipts of local deliveries, by when they were delivered, until the journal lists them. */
+    delivered = new Map();
+    controller = new AbortController();
+    running = Promise.resolve();
+    stopping;
+    constructor(state, fields, onWrite, onGap) {
+        this.state = state;
+        this.fields = fields;
+        this.onWrite = onWrite;
+        this.onGap = onGap;
+    }
+    start(mongoDbArg, cursorArg) {
+        this.state.followers.add(this);
+        this.running = this.follow(mongoDbArg, cursorArg);
+    }
+    stop() {
+        this.stopping ??= (async () => {
+            this.state.followers.delete(this);
+            this.controller.abort();
+            await this.running;
+        })();
+        return this.stopping;
+    }
+    deliverLocal(commitArg) {
+        if (this.controller.signal.aborted)
+            return;
+        this.delivered.set(commitArg.receipt, Date.now());
+        this.deliver('local', null, null, commitArg.entry.reports, commitArg.entry.unplaced);
+    }
+    deliver(originArg, stampArg, committedAtMsArg, reportsArg, unplacedArg) {
+        const write = Object.freeze({
+            origin: originArg,
+            stamp: stampArg,
+            committedAtMs: committedAtMsArg,
+            reports: Object.freeze(reportsArg.map((reportArg) => narrowSmartdataWriteReport(reportArg, this.fields))),
+            unplaced: Object.freeze([...unplacedArg]),
+        });
+        try {
+            this.onWrite(write);
+        }
+        catch (errorArg) {
+            logger.log('error', `A SmartData write follower threw on a commit: ${describeError(errorArg)}`);
+        }
+    }
+    reportGap(reasonArg) {
+        try {
+            this.onGap(Object.freeze({ reason: reasonArg }));
+        }
+        catch (errorArg) {
+            logger.log('error', `A SmartData write follower threw on a gap: ${describeError(errorArg)}`);
+        }
+    }
+    /**
+     * Reads the journal from `cursorArg` on until stopped. A failed read is
+     * retried from the same position; a position the journal lost reports a gap
+     * and continues from its head.
+     */
+    async follow(mongoDbArg, cursorArg) {
+        const signal = this.controller.signal;
+        let cursor = cursorArg;
+        let lastCommitAt = Number.NEGATIVE_INFINITY;
+        let failing = false;
+        while (!signal.aborted) {
+            try {
+                let page;
+                do {
+                    page = await readCommittedWrites(mongoDbArg, cursor, signal);
+                    if (page.gap) {
+                        // A position beyond the head belongs to a history the journal no longer continues.
+                        const reason = page.head.timeline !== cursor.timeline
+                            || BigInt(cursor.sequence) > BigInt(page.head.sequence) ? 'timeline' : 'retention';
+                        cursor = (await readCommittedWrites(mongoDbArg, undefined, signal)).cursor;
+                        this.reportGap(reason);
+                        break;
+                    }
+                    const committed = await this.deliverPage(mongoDbArg, page.writes, signal);
+                    if (signal.aborted)
+                        return;
+                    if (committed)
+                        lastCommitAt = performance.now();
+                    cursor = page.cursor;
+                } while (page.hasMore && !signal.aborted);
+                if (failing) {
+                    failing = false;
+                    logger.log('info', `A SmartData write follower of "${mongoDbArg.databaseName}" reads the commit journal again.`);
+                }
+            }
+            catch (errorArg) {
+                if (signal.aborted)
+                    return;
+                if (!failing) {
+                    failing = true;
+                    logger.log('warn', `A SmartData write follower of "${mongoDbArg.databaseName}" failed to read the commit journal and retries: ${describeError(errorArg)}`);
+                }
+            }
+            this.forgetOldDeliveries();
+            await pause(performance.now() - lastCommitAt < activeWindowMs ? activePollMs : idlePollMs, signal);
+        }
+    }
+    /**
+     * Delivers one page's commits in order and returns whether it held any.
+     * A commit of this database instance still settling is waited for, so the
+     * follower knows whether it was delivered locally. Every read happens before
+     * the first delivery, so a failed read delivers nothing and is retried with
+     * the page.
+     */
+    async deliverPage(mongoDbArg, writesArg, signalArg) {
+        const writes = writesArg.filter((writeArg) => writeArg.collections.length > 0 || (writeArg.logged && writeArg.receipt !== undefined));
+        if (writes.length === 0)
+            return false;
+        const receipts = writes.flatMap((writeArg) => writeArg.receipt === undefined ? [] : [writeArg.receipt]);
+        for (const receipt of receipts) {
+            const pending = this.state.pending.get(receipt);
+            if (pending)
+                await settledOrAborted(pending, signalArg);
+        }
+        if (signalArg.aborted)
+            return true;
+        const lookups = receipts.filter((receiptArg) => !this.delivered.has(receiptArg));
+        const documents = new Map();
+        if (lookups.length > 0) {
+            const found = await logCollection(mongoDbArg).find({ _id: { $in: lookups } }, { projection: { at: 0 }, timeoutMS: readTimeoutMs, signal: signalArg }).toArray();
+            for (const document of found)
+                documents.set(document._id, document);
+        }
+        for (const write of writes) {
+            if (signalArg.aborted)
+                return true;
+            if (write.receipt !== undefined && this.delivered.delete(write.receipt))
+                continue;
+            const entry = write.receipt === undefined
+                ? undefined
+                : entryOfDocument(documents.get(write.receipt), this.fields);
+            const unplaced = new Set(entry?.unplaced);
+            const covered = new Set([...unplaced, ...(entry?.reports ?? []).map((reportArg) => reportArg.collection)]);
+            for (const collection of write.collections) {
+                if (!covered.has(collection))
+                    unplaced.add(collection);
+            }
+            this.deliver('journal', write.stamp, write.committedAtMs, entry?.reports ?? [], [...unplaced].sort());
+        }
+        return true;
+    }
+    forgetOldDeliveries() {
+        const oldest = Date.now() - localDeliveryMemoryMs;
+        for (const [receipt, deliveredAt] of this.delivered) {
+            if (deliveredAt < oldest)
+                this.delivered.delete(receipt);
+        }
+    }
+}
+/**
+ * @internal Starts a follower at the journal's head; `db.followWrites()`
+ * documents it.
+ */
+export const followSmartdataWrites = async (dbArg, optionsArg) => {
+    const { fields, onWrite, onGap } = assertDataOptions(optionsArg, ['fields', 'onWrite', 'onGap']);
+    const followed = normalizeObservedFields(fields, 'A SmartData write follower');
+    if (typeof onWrite !== 'function' || typeof onGap !== 'function') {
+        throw new SmartdataPersistenceError('invalid_argument', 'A SmartData write follower requires onWrite and onGap functions.');
+    }
+    const logged = logFields.get(dbArg);
+    if (logged === undefined) {
+        throw new SmartdataPersistenceError('unsupported_operation', 'Following writes requires the writeLog option of the SmartdataDb.');
+    }
+    if (!followed.every((fieldArg) => logged.includes(fieldArg))) {
+        throw new SmartdataPersistenceError('invalid_argument', 'A SmartData write follower follows fields of the write log only.');
+    }
+    const mongoDb = dbArg.mongoDb;
+    if (dbArg.status !== 'connected' || !mongoDb) {
+        throw new SmartdataPersistenceError('unsupported_operation', 'Following writes requires a connected SmartdataDb.');
+    }
+    if (!isSmartdataWriteLogActive(dbArg)) {
+        throw new SmartdataPersistenceError('unsupported_operation', 'Following writes requires NoSQLDB 10.9.0 or newer, whose commit journal orders the commits.');
+    }
+    const tail = await readCommittedWrites(mongoDb, undefined);
+    if (dbArg.status !== 'connected' || dbArg.mongoDb !== mongoDb) {
+        throw new SmartdataPersistenceError('unsupported_operation', 'The SmartdataDb closed while the write follower started.');
+    }
+    const follower = new SmartdataWriteFollower(stateOf(dbArg), followed, onWrite, onGap);
+    follower.start(mongoDb, tail.cursor);
+    return Object.freeze({ stop: () => follower.stop() });
+};
+/** @internal Stops every follower of the database; `close()` calls it. */
+export const stopSmartdataWriteFollowers = async (dbArg) => {
+    const followers = logStates.get(dbArg)?.followers;
+    if (!followers)
+        return;
+    await Promise.all([...followers].map((followerArg) => followerArg.stop()));
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy53cml0ZWxvZy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL25vc3FsZGIvY2xhc3Nlcy53cml0ZWxvZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUd4QyxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUNqRSxPQUFPLEVBQUUseUJBQXlCLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUNyRSxPQUFPLEVBQ0wsMEJBQTBCLEVBQzFCLHVCQUF1QixFQUN2QixzQkFBc0IsR0FHdkIsTUFBTSw0QkFBNEIsQ0FBQztBQUNwQyxPQUFPLEVBQUUsK0JBQStCLEVBQUUsNEJBQTRCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUM1RyxPQUFPLEVBQUUsc0JBQXNCLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUM3RCxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sY0FBYyxDQUFDO0FBK0V0Qyw2Q0FBNkM7QUFDN0MsTUFBTSxDQUFDLE1BQU0sc0JBQXNCLEdBQUcsdUJBQXVCLENBQUM7QUFFOUQsMkZBQTJGO0FBQzNGLE1BQU0sQ0FBQyxNQUFNLHdCQUF3QixHQUFHLEVBQUUsR0FBRyxFQUFFLENBQUM7QUFDaEQsTUFBTSxlQUFlLEdBQUcsNEJBQTRCLENBQUM7QUFDckQsTUFBTSxZQUFZLEdBQUcsR0FBRyxDQUFDO0FBQ3pCLE1BQU0sVUFBVSxHQUFHLEtBQUssQ0FBQztBQUN6QiwyRUFBMkU7QUFDM0UsTUFBTSxjQUFjLEdBQUcsTUFBTSxDQUFDO0FBQzlCLE1BQU0sU0FBUyxHQUFHLEdBQUcsQ0FBQztBQUN0Qix1RkFBdUY7QUFDdkYsTUFBTSxTQUFTLEdBQUcsQ0FBQyxHQUFHLElBQUksR0FBRyxJQUFJLENBQUM7QUFDbEMsTUFBTSxhQUFhLEdBQUcsS0FBSyxDQUFDO0FBQzVCLHdGQUF3RjtBQUN4RixNQUFNLHFCQUFxQixHQUFHLEtB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

package/dist_ts/nosqldb/classes.writeobserver.d.ts

@@ -59,10 +59,23 @@ export interface ISmartdataWrite {
      */
     previousPartitionsRead?: true;
 }
+/**
+ * @internal Validates the top-level field names a report carries: 1 to 64
+ * distinct names, no `.` and no leading `$`. `subjectArg` names what requires
+ * them in the refusal.
+ */
+export declare const normalizeObservedFields: (fieldsArg: unknown, subjectArg: string) => readonly string[];
 /** @internal Registers a write observer; the returned function removes it. */
 export declare const addSmartdataWriteObserver: (dbArg: SmartdataDb, optionsArg: ISmartdataWriteObserverOptions) => (() => void);
 /** @internal */
 export declare const hasSmartdataWriteObservers: (dbArg: SmartdataDb) => boolean;
+/**
+ * @internal The report of one acknowledged write with the values of `fieldsArg`,
+ * copied now and frozen.
+ */
+export declare const reportOfSmartdataWrite: (writeArg: ISmartdataWrite, fieldsArg: readonly string[]) => ISmartdataWriteReport;
+/** @internal The same report with only the values of `fieldsArg`, which the report's fields include. */
+export declare const narrowSmartdataWriteReport: (reportArg: ISmartdataWriteReport, fieldsArg: readonly string[]) => ISmartdataWriteReport;
 /**
  * @internal Captures one acknowledged write for the observers registered now,
  * and returns the delivery, or `undefined` when nobody observes the database.