typeferry 0.6.0

package/dist/mongodb/live/observer.js

@@ -0,0 +1,246 @@
+import { EJSON } from '../../ejson/index.js';
+import { readLiveId } from './source.js';
+import { createMongoLiveWindowSplice } from './window.js';
+const MAX_HANDOFF_NOTICES = 10_000;
+/** Maintains query membership and emits semantic document operations. */
+export class MongoLiveObserver {
+    options;
+    documents = new Map();
+    orderedDocuments = [];
+    bufferedNotices = [];
+    unsubscribeSource = null;
+    initializing = true;
+    initializationInvalidated = false;
+    stopped = false;
+    sequence = 0;
+    work = Promise.resolve();
+    orderedRefreshRunning = false;
+    orderedRefreshPending = false;
+    /** Creates one connection-private observer. */
+    constructor(options) {
+        this.options = options;
+    }
+    /** Builds an atomic snapshot and starts ordered delta delivery. */
+    async start() {
+        this.unsubscribeSource = this.options.source.subscribe(notice => {
+            if (this.initializing) {
+                if (notice.type === 'reset') {
+                    this.initializationInvalidated = true;
+                    return;
+                }
+                if (this.bufferedNotices.length >= MAX_HANDOFF_NOTICES) {
+                    this.initializationInvalidated = true;
+                    return;
+                }
+                this.bufferedNotices.push(notice);
+                return;
+            }
+            if (notice.type === 'reset') {
+                this.options.onStale();
+                void this.stop();
+                return;
+            }
+            if (this.options.window) {
+                this.enqueueOrderedRefresh();
+                return;
+            }
+            this.enqueue(notice);
+        });
+        const snapshotDocuments = await this.readSnapshotDocuments();
+        this.assertInitializationValid();
+        if (!this.options.window &&
+            snapshotDocuments.length > this.options.maxSnapshotDocuments) {
+            await this.stop();
+            throw new Error(`MongoDB live snapshot exceeds ${this.options.maxSnapshotDocuments} documents.`);
+        }
+        const projectedDocuments = [];
+        for (const document of snapshotDocuments) {
+            const projected = await this.project(document);
+            this.assertInitializationValid();
+            projectedDocuments.push(projected);
+        }
+        if (this.options.window) {
+            this.orderedDocuments = projectedDocuments;
+        }
+        else {
+            for (const projected of projectedDocuments) {
+                this.documents.set(canonicalId(projected._id), projected);
+            }
+        }
+        while (this.bufferedNotices.length > 0) {
+            this.assertInitializationValid();
+            const notices = this.bufferedNotices.splice(0);
+            for (const notice of notices) {
+                await this.applyNotice(notice, false);
+                this.assertInitializationValid();
+            }
+        }
+        this.assertInitializationValid();
+        this.initializing = false;
+        return {
+            subscriptionId: this.options.subscriptionId,
+            generation: this.options.generation,
+            sequence: this.sequence,
+            ordered: Boolean(this.options.window),
+            documents: this.options.window
+                ? this.orderedDocuments
+                : [...this.documents.values()],
+        };
+    }
+    /** Stops source delivery and drains membership work. */
+    async stop() {
+        if (this.stopped)
+            return;
+        this.stopped = true;
+        this.unsubscribeSource?.();
+        this.unsubscribeSource = null;
+        await this.work.catch(() => undefined);
+        this.bufferedNotices.length = 0;
+    }
+    enqueue(notice) {
+        this.work = this.work
+            .then(() => this.applyNotice(notice, true))
+            .catch(() => {
+            if (!this.stopped)
+                this.options.onStale();
+        });
+    }
+    enqueueOrderedRefresh() {
+        if (this.orderedRefreshRunning) {
+            this.orderedRefreshPending = true;
+            return;
+        }
+        this.orderedRefreshRunning = true;
+        this.work = this.work
+            .then(async () => {
+            do {
+                this.orderedRefreshPending = false;
+                await this.refreshOrderedWindow(true);
+            } while (this.orderedRefreshPending && !this.stopped);
+        })
+            .catch(() => {
+            if (!this.stopped)
+                this.options.onStale();
+        })
+            .finally(() => {
+            this.orderedRefreshRunning = false;
+            this.orderedRefreshPending = false;
+        });
+    }
+    assertInitializationValid() {
+        if (!this.initializationInvalidated)
+            return;
+        void this.stop();
+        throw new Error('MongoDB live source reset while the initial snapshot was being built.');
+    }
+    async applyNotice(notice, emit) {
+        if (this.stopped)
+            return;
+        if (notice.type === 'reset') {
+            if (emit)
+                this.options.onStale();
+            return;
+        }
+        if (this.options.window) {
+            await this.refreshOrderedWindow(emit);
+            return;
+        }
+        const clientId = toClientId(notice.id, this.options.typedObjectIds ?? false);
+        const key = canonicalId(clientId);
+        const previous = this.documents.get(key);
+        let operation = null;
+        if (notice.deleted) {
+            if (previous) {
+                this.documents.delete(key);
+                operation = { type: 'removed', id: clientId };
+            }
+        }
+        else {
+            const current = await this.options.collection.findOne({
+                $and: [
+                    this.options.filter,
+                    { _id: notice.id },
+                ],
+            }, { readConcern: { level: 'majority' } });
+            if (!current && previous) {
+                this.documents.delete(key);
+                operation = { type: 'removed', id: clientId };
+            }
+            else if (current) {
+                const projected = await this.project(current);
+                this.documents.set(key, projected);
+                if (!previous) {
+                    operation = { type: 'added', document: projected };
+                }
+                else if (!EJSON.equals(previous, projected)) {
+                    operation = { type: 'changed', document: projected };
+                }
+            }
+        }
+        if (!operation || !emit)
+            return;
+        this.options.onDelta({
+            type: 'delta',
+            subscriptionId: this.options.subscriptionId,
+            generation: this.options.generation,
+            sequence: ++this.sequence,
+            operations: [operation],
+        });
+    }
+    async readSnapshotDocuments() {
+        let cursor = this.options.collection.find(this.options.filter, {
+            readConcern: { level: 'majority' },
+        });
+        if (this.options.window) {
+            cursor = cursor
+                .sort(this.options.window.sort)
+                .skip(this.options.window.skip)
+                .limit(this.options.window.limit);
+        }
+        else {
+            cursor = cursor.limit(this.options.maxSnapshotDocuments + 1);
+        }
+        return cursor.toArray();
+    }
+    async refreshOrderedWindow(emit) {
+        const storedDocuments = await this.readSnapshotDocuments();
+        const current = [];
+        for (const document of storedDocuments) {
+            current.push(await this.project(document));
+        }
+        if (this.stopped)
+            return;
+        const operation = createMongoLiveWindowSplice(this.orderedDocuments, current);
+        this.orderedDocuments = current;
+        if (!operation || !emit)
+            return;
+        this.options.onDelta({
+            type: 'delta',
+            subscriptionId: this.options.subscriptionId,
+            generation: this.options.generation,
+            sequence: ++this.sequence,
+            operations: [operation],
+        });
+    }
+    async project(document) {
+        const sourceId = readLiveId(document._id);
+        if (sourceId === null) {
+            throw new Error('MongoDB live publications require ObjectId, string, or number "_id".');
+        }
+        const fields = await this.options.project(document);
+        if ('_id' in fields) {
+            throw new Error('MongoDB live projectors must not return "_id".');
+        }
+        return Object.assign({ _id: toClientId(sourceId, this.options.typedObjectIds ?? false) }, fields);
+    }
+}
+function toClientId(id, typedObjectIds) {
+    if (typeof id !== 'object')
+        return id;
+    return typedObjectIds ? { $objectId: id.toHexString() } : id.toHexString();
+}
+/** Creates a stable type-tagged EJSON identity key. */
+export function canonicalId(id) {
+    return EJSON.stringify(id, { canonical: true });
+}
+//# sourceMappingURL=observer.js.map

package/dist/mongodb/live/observer.js.map

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

package/dist/mongodb/live/publication.d.ts

@@ -0,0 +1,4 @@
+import type { Document } from 'mongodb';
+import type { MongoLiveClientDocument, MongoLivePublicationConfig, MongoLivePublicationDefinition, MongoLivePublicationDescriptor } from './types.js';
+/** Binds a client descriptor to its validated server-owned MongoDB query. */
+export declare function defineMongoLivePublication<const TName extends string, TArgs, TScope, TStoredDocument extends Document, TFields extends object>(descriptor: MongoLivePublicationDescriptor<TName, TArgs, MongoLiveClientDocument<TFields>>, config: MongoLivePublicationConfig<TArgs, TScope, TStoredDocument, TFields>): MongoLivePublicationDefinition<typeof descriptor>;

package/dist/mongodb/live/publication.js

@@ -0,0 +1,30 @@
+/** Binds a client descriptor to its validated server-owned MongoDB query. */
+export function defineMongoLivePublication(descriptor, config) {
+    return {
+        descriptor,
+        name: descriptor.name,
+        collection: config.collection,
+        protected: config.protected ?? true,
+        parseArgs(value) {
+            return config.args.parse(value);
+        },
+        async authorize(context, args) {
+            return config.authorize(context, args);
+        },
+        filter(scope, args) {
+            return config.filter(scope, args);
+        },
+        window(scope, args) {
+            const window = config.window?.(scope, args);
+            return window ?? null;
+        },
+        async project(document, scope) {
+            const projected = await config.project(document, scope);
+            if ('_id' in projected) {
+                throw new Error(`MongoDB live publication "${descriptor.name}" must not project "_id".`);
+            }
+            return projected;
+        },
+    };
+}
+//# sourceMappingURL=publication.js.map

package/dist/mongodb/live/publication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publication.js","sourceRoot":"","sources":["../../../src/mongodb/live/publication.ts"],"names":[],"mappings":"AAWA,6EAA6E;AAC7E,MAAM,UAAU,0BAA0B,CAOxC,UAIC,EACD,MAKC;IAED,OAAO;QACL,UAAU;QACV,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,UAAU,EACR,MAAM,CAAC,UAEQ;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;QACnC,SAAS,CAAC,KAAc;YACtB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACjC,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI;YAC3B,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,IAAa,CAAC,CAAA;QACjD,CAAC;QACD,MAAM,CAAC,KAAK,EAAE,IAAI;YAChB,OAAO,MAAM,CAAC,MAAM,CAAC,KAAe,EAAE,IAAa,CAAC,CAAA;QACtD,CAAC;QACD,MAAM,CAAC,KAAK,EAAE,IAAI;YAChB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,KAAe,EAAE,IAAa,CAAC,CAAA;YAC9D,OAAQ,MAA2C,IAAI,IAAI,CAAA;QAC7D,CAAC;QACD,KAAK,CAAC,OAAO,CACX,QAAQ,EACR,KAAK;YAEL,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,OAAO,CACpC,QAA2B,EAC3B,KAAe,CAChB,CAAA;YACD,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CACb,6BAA6B,UAAU,CAAC,IAAI,2BAA2B,CACxE,CAAA;YACH,CAAC;YACD,OAAO,SAAS,CAAA;QAClB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/mongodb/live/source.d.ts

@@ -0,0 +1,55 @@
+import type { Collection, Document } from 'mongodb';
+import { type MongoLiveSourceId } from './types.js';
+/** Normalized collection change consumed by live observers. */
+export type MongoLiveSourceNotice = {
+    readonly type: 'change';
+    readonly sequence: number;
+    readonly id: MongoLiveSourceId;
+    readonly deleted: boolean;
+} | {
+    readonly type: 'reset';
+    readonly sequence: number;
+    readonly reason: 'invalidated' | 'resume-failed';
+};
+/** Listener registered by one live observer. */
+export type MongoLiveSourceListener = (notice: MongoLiveSourceNotice) => void | Promise<void>;
+/** Change-source contract used by observers and deterministic tests. */
+export interface MongoLiveChangeSource {
+    /** Waits until the collection change stream is established. */
+    start(): Promise<void>;
+    /** Registers an ordered notice listener. */
+    subscribe(listener: MongoLiveSourceListener): () => void;
+    /** Closes the source and waits for its worker to finish. */
+    close(): Promise<void>;
+}
+/** One resumable MongoDB change stream shared by a collection. */
+export declare class MongoLiveCollectionSource implements MongoLiveChangeSource {
+    private readonly collection;
+    private readonly listeners;
+    private stream;
+    private worker;
+    private starting;
+    private closed;
+    private ready;
+    private readiness;
+    private sequence;
+    private resumeToken;
+    /** Creates a source for one native MongoDB collection. */
+    constructor(collection: Collection<Document>);
+    /** Establishes the stream before subscriptions are allowed to snapshot. */
+    start(): Promise<void>;
+    /** Registers a listener and returns idempotent removal. */
+    subscribe(listener: MongoLiveSourceListener): () => void;
+    /** Stops the stream and drains the active worker. */
+    close(): Promise<void>;
+    private openStream;
+    private establishInitial;
+    private consume;
+    private resetAndReopen;
+    private dispatchChange;
+    private dispatch;
+    private markUnavailable;
+    private markReady;
+}
+/** Validates a MongoDB source identifier for EJSON client materialization. */
+export declare function readLiveId(value: unknown): MongoLiveSourceId | null;

package/dist/mongodb/live/source.js

@@ -0,0 +1,197 @@
+import { MONGO_LIVE_SOURCE_RETRY_MS, } from './types.js';
+/** One resumable MongoDB change stream shared by a collection. */
+export class MongoLiveCollectionSource {
+    collection;
+    listeners = new Set();
+    stream = null;
+    worker = null;
+    starting = null;
+    closed = false;
+    ready = false;
+    readiness = createDeferred();
+    sequence = 0;
+    resumeToken = null;
+    /** Creates a source for one native MongoDB collection. */
+    constructor(collection) {
+        this.collection = collection;
+    }
+    /** Establishes the stream before subscriptions are allowed to snapshot. */
+    async start() {
+        if (this.closed) {
+            throw new Error('MongoDB live change source is closed.');
+        }
+        if (this.ready)
+            return;
+        if (this.worker) {
+            await this.readiness.promise;
+            if (this.closed || !this.ready) {
+                throw new Error('MongoDB live change source is closed.');
+            }
+            return;
+        }
+        if (!this.starting) {
+            this.starting = this.establishInitial().finally(() => {
+                this.starting = null;
+            });
+        }
+        await this.starting;
+    }
+    /** Registers a listener and returns idempotent removal. */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /** Stops the stream and drains the active worker. */
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.readiness.resolve();
+        await this.stream?.close().catch(() => undefined);
+        await this.starting?.catch(() => undefined);
+        await this.worker?.catch(() => undefined);
+        this.listeners.clear();
+    }
+    openStream() {
+        return this.collection.watch([], {
+            fullDocument: 'updateLookup',
+            maxAwaitTimeMS: 100,
+            ...(this.resumeToken ? { resumeAfter: this.resumeToken } : {}),
+        });
+    }
+    async establishInitial() {
+        try {
+            this.stream = this.openStream();
+            const first = await this.stream.tryNext();
+            if (first)
+                await this.dispatchChange(first);
+            if (this.closed) {
+                throw new Error('MongoDB live change source is closed.');
+            }
+            this.markReady();
+            this.worker = this.consume();
+        }
+        catch (error) {
+            await this.stream?.close().catch(() => undefined);
+            this.stream = null;
+            throw error;
+        }
+    }
+    async consume() {
+        while (!this.closed) {
+            try {
+                if (!this.stream)
+                    this.stream = this.openStream();
+                for await (const change of this.stream) {
+                    if (this.closed)
+                        return;
+                    await this.dispatchChange(change);
+                }
+                if (!this.closed) {
+                    await this.resetAndReopen('resume-failed');
+                }
+            }
+            catch {
+                if (this.closed)
+                    return;
+                await this.resetAndReopen('resume-failed');
+            }
+        }
+    }
+    async resetAndReopen(reason) {
+        this.markUnavailable();
+        await this.stream?.close().catch(() => undefined);
+        this.stream = null;
+        await this.dispatch({ type: 'reset', sequence: ++this.sequence, reason });
+        while (!this.closed && !this.ready) {
+            await delay(MONGO_LIVE_SOURCE_RETRY_MS);
+            try {
+                this.stream = this.openStream();
+                const first = await this.stream.tryNext();
+                if (first)
+                    await this.dispatchChange(first);
+                this.markReady();
+            }
+            catch {
+                await this.stream?.close().catch(() => undefined);
+                this.resumeToken = null;
+                this.stream = null;
+            }
+        }
+    }
+    async dispatchChange(change) {
+        this.resumeToken = change._id;
+        if (change.operationType === 'invalidate') {
+            this.markUnavailable();
+            await this.dispatch({
+                type: 'reset',
+                sequence: ++this.sequence,
+                reason: 'invalidated',
+            });
+            return;
+        }
+        if (!('documentKey' in change))
+            return;
+        const id = readLiveId(change.documentKey?._id);
+        if (id === null)
+            return;
+        await this.dispatch({
+            type: 'change',
+            sequence: ++this.sequence,
+            id,
+            deleted: change.operationType === 'delete',
+        });
+    }
+    async dispatch(notice) {
+        for (const listener of this.listeners) {
+            try {
+                await listener(notice);
+            }
+            catch {
+                // One observer must not interrupt the shared collection source.
+            }
+        }
+    }
+    markUnavailable() {
+        if (!this.ready)
+            return;
+        this.ready = false;
+        this.readiness = createDeferred();
+    }
+    markReady() {
+        if (this.ready)
+            return;
+        this.ready = true;
+        this.readiness.resolve();
+    }
+}
+/** Validates a MongoDB source identifier for EJSON client materialization. */
+export function readLiveId(value) {
+    if (typeof value === 'string' || typeof value === 'number')
+        return value;
+    if (value &&
+        typeof value === 'object' &&
+        value.constructor.name === 'ObjectId' &&
+        typeof value.toHexString === 'function') {
+        return value;
+    }
+    return null;
+}
+function delay(milliseconds) {
+    return new Promise(resolve => {
+        setTimeout(resolve, milliseconds);
+    });
+}
+function createDeferred() {
+    let resolvePromise = null;
+    const promise = new Promise(resolve => {
+        resolvePromise = resolve;
+    });
+    return {
+        promise,
+        resolve: () => resolvePromise?.(),
+    };
+}
+//# sourceMappingURL=source.js.map

package/dist/mongodb/live/source.js.map

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