@lossless.org/client 0.1.0

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

@@ -0,0 +1,30 @@
+import { SmartdataCollection, type INormalizedCollectionModelSchema } from './classes.collection.js';
+import { SmartdataDb } from './classes.db.js';
+/**
+ * Per-SmartdataDb collection cache.
+ *
+ * Historically this class keyed its cache by class name alone, which meant
+ * the first SmartdataDb to request a collection of a given class name
+ * "won" — every subsequent call from a different SmartdataDb instance
+ * received the cached collection bound to the first db. That silently
+ * broke multi-tenant SaaS apps (one db per tenant), tests instantiating
+ * multiple SmartdataDbs in sequence, and any in-process db cluster switch.
+ *
+ * The cache is now keyed by `(SmartdataDb instance, className)` using a
+ * WeakMap of db → Map<className, SmartdataCollection>. Entries are GC'd
+ * with their parent db automatically.
+ */
+export declare class CollectionFactory {
+    private perDbCollections;
+    getCollection: (nameArg: string, dbArg: SmartdataDb, schemaArg?: INormalizedCollectionModelSchema) => SmartdataCollection<any>;
+    /**
+     * @deprecated Internal back-compat shim. The previous field was a public
+     * Record<className, SmartdataCollection> but was not part of the
+     * documented public API. WeakMap is not iterable, so this getter returns
+     * an empty object — anyone actually relying on the old shape would get
+     * clean nothing rather than wrong-db data. Will be removed in 8.0.
+     */
+    get collections(): {
+        [key: string]: SmartdataCollection<any>;
+    };
+}

package/dist_ts/nosqldb/classes.collectionfactory.js

@@ -0,0 +1,65 @@
+import * as plugins from './plugins.js';
+import { SmartdataCollection, } from './classes.collection.js';
+import { SmartdataDb } from './classes.db.js';
+import { SmartdataPersistenceError } from './classes.persistence.js';
+/**
+ * Per-SmartdataDb collection cache.
+ *
+ * Historically this class keyed its cache by class name alone, which meant
+ * the first SmartdataDb to request a collection of a given class name
+ * "won" — every subsequent call from a different SmartdataDb instance
+ * received the cached collection bound to the first db. That silently
+ * broke multi-tenant SaaS apps (one db per tenant), tests instantiating
+ * multiple SmartdataDbs in sequence, and any in-process db cluster switch.
+ *
+ * The cache is now keyed by `(SmartdataDb instance, className)` using a
+ * WeakMap of db → Map<className, SmartdataCollection>. Entries are GC'd
+ * with their parent db automatically.
+ */
+export class CollectionFactory {
+    perDbCollections = new WeakMap();
+    getCollection = (nameArg, dbArg, schemaArg) => {
+        if (!(dbArg instanceof SmartdataDb)) {
+            // Preserve the historical behavior of returning undefined-ish for
+            // non-db args. All in-repo callers already guard on instanceof
+            // before using the result (see classes.collection.ts).
+            return undefined;
+        }
+        let dbMap = this.perDbCollections.get(dbArg);
+        if (!dbMap) {
+            dbMap = new Map();
+            this.perDbCollections.set(dbArg, dbMap);
+        }
+        let entry = dbMap.get(nameArg);
+        if (!entry) {
+            const collection = new SmartdataCollection(nameArg, dbArg);
+            entry = { collection, schema: schemaArg };
+            if (schemaArg) {
+                collection.bindModelSchema(schemaArg);
+            }
+            dbMap.set(nameArg, entry);
+        }
+        else if (schemaArg) {
+            if (entry.schema &&
+                entry.schema.fingerprint !== schemaArg.fingerprint) {
+                throw new SmartdataPersistenceError('invalid_configuration', `Collection "${nameArg}" already has a divergent model schema in this SmartdataDb.`);
+            }
+            if (!entry.schema) {
+                entry.schema = schemaArg;
+            }
+            entry.collection.bindModelSchema(schemaArg);
+        }
+        return entry.collection;
+    };
+    /**
+     * @deprecated Internal back-compat shim. The previous field was a public
+     * Record<className, SmartdataCollection> but was not part of the
+     * documented public API. WeakMap is not iterable, so this getter returns
+     * an empty object — anyone actually relying on the old shape would get
+     * clean nothing rather than wrong-db data. Will be removed in 8.0.
+     */
+    get collections() {
+        return {};
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jb2xsZWN0aW9uZmFjdG9yeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL25vc3FsZGIvY2xhc3Nlcy5jb2xsZWN0aW9uZmFjdG9yeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUN4QyxPQUFPLEVBQ0wsbUJBQW1CLEdBRXBCLE1BQU0seUJBQXlCLENBQUM7QUFDakMsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBQzlDLE9BQU8sRUFBRSx5QkFBeUIsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBRXJFOzs7Ozs7Ozs7Ozs7O0dBYUc7QUFDSCxNQUFNLE9BQU8saUJBQWlCO0lBQ3BCLGdCQUFnQixHQVNwQixJQUFJLE9BQU8sRUFBRSxDQUFDO0lBRVgsYUFBYSxHQUFHLENBQ3JCLE9BQWUsRUFDZixLQUFrQixFQUNsQixTQUE0QyxFQUNsQixFQUFFO1FBQzVCLElBQUksQ0FBQyxDQUFDLEtBQUssWUFBWSxXQUFXLENBQUMsRUFBRSxDQUFDO1lBQ3BDLGtFQUFrRTtZQUNsRSwrREFBK0Q7WUFDL0QsdURBQXVEO1lBQ3ZELE9BQU8sU0FBZ0QsQ0FBQztRQUMxRCxDQUFDO1FBQ0QsSUFBSSxLQUFLLEdBQUcsSUFBSSxDQUFDLGdCQUFnQixDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUM3QyxJQUFJLENBQUMsS0FBSyxFQUFFLENBQUM7WUFDWCxLQUFLLEdBQUcsSUFBSSxHQUFHLEVBQUUsQ0FBQztZQUNsQixJQUFJLENBQUMsZ0JBQWdCLENBQUMsR0FBRyxDQUFDLEtBQUssRUFBRSxLQUFLLENBQUMsQ0FBQztRQUMxQyxDQUFDO1FBQ0QsSUFBSSxLQUFLLEdBQUcsS0FBSyxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUMvQixJQUFJLENBQUMsS0FBSyxFQUFFLENBQUM7WUFDWCxNQUFNLFVBQVUsR0FBRyxJQUFJLG1CQUFtQixDQUFDLE9BQU8sRUFBRSxLQUFLLENBQUMsQ0FBQztZQUMzRCxLQUFLLEdBQUcsRUFBRSxVQUFVLEVBQUUsTUFBTSxFQUFFLFNBQVMsRUFBRSxDQUFDO1lBQzFDLElBQUksU0FBUyxFQUFFLENBQUM7Z0JBQ2QsVUFBVSxDQUFDLGVBQWUsQ0FBQyxTQUFTLENBQUMsQ0FBQztZQUN4QyxDQUFDO1lBQ0QsS0FBSyxDQUFDLEdBQUcsQ0FBQyxPQUFPLEVBQUUsS0FBSyxDQUFDLENBQUM7UUFDNUIsQ0FBQzthQUFNLElBQUksU0FBUyxFQUFFLENBQUM7WUFDckIsSUFDRSxLQUFLLENBQUMsTUFBTTtnQkFDWixLQUFLLENBQUMsTUFBTSxDQUFDLFdBQVcsS0FBSyxTQUFTLENBQUMsV0FBVyxFQUNsRCxDQUFDO2dCQUNELE1BQU0sSUFBSSx5QkFBeUIsQ0FDakMsdUJBQXVCLEVBQ3ZCLGVBQWUsT0FBTyw2REFBNkQsQ0FDcEYsQ0FBQztZQUNKLENBQUM7WUFDRCxJQUFJLENBQUMsS0FBSyxDQUFDLE1BQU0sRUFBRSxDQUFDO2dCQUNsQixLQUFLLENBQUMsTUFBTSxHQUFHLFNBQVMsQ0FBQztZQUMzQixDQUFDO1lBQ0QsS0FBSyxDQUFDLFVBQVUsQ0FBQyxlQUFlLENBQUMsU0FBUyxDQUFDLENBQUM7UUFDOUMsQ0FBQztRQUNELE9BQU8sS0FBSyxDQUFDLFVBQVUsQ0FBQztJQUMxQixDQUFDLENBQUM7SUFFRjs7Ozs7O09BTUc7SUFDSCxJQUFXLFdBQVc7UUFDcEIsT0FBTyxFQUFFLENBQUM7SUFDWixDQUFDO0NBQ0YifQ==

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

@@ -0,0 +1,4 @@
+type TCollectionReconnectHandler = () => void;
+export declare const registerCollectionReconnectHandler: (collectionArg: object, handlerArg: TCollectionReconnectHandler) => void;
+export declare const notifyCollectionReconnect: (collectionArg: object) => void;
+export {};

package/dist_ts/nosqldb/classes.collectionlifecycle.js

@@ -0,0 +1,15 @@
+const reconnectHandlersByCollection = new WeakMap();
+export const registerCollectionReconnectHandler = (collectionArg, handlerArg) => {
+    let handlers = reconnectHandlersByCollection.get(collectionArg);
+    if (!handlers) {
+        handlers = new Set();
+        reconnectHandlersByCollection.set(collectionArg, handlers);
+    }
+    handlers.add(handlerArg);
+};
+export const notifyCollectionReconnect = (collectionArg) => {
+    for (const handler of reconnectHandlersByCollection.get(collectionArg) || []) {
+        handler();
+    }
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jb2xsZWN0aW9ubGlmZWN5Y2xlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvbm9zcWxkYi9jbGFzc2VzLmNvbGxlY3Rpb25saWZlY3ljbGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsTUFBTSw2QkFBNkIsR0FBRyxJQUFJLE9BQU8sRUFHOUMsQ0FBQztBQUVKLE1BQU0sQ0FBQyxNQUFNLGtDQUFrQyxHQUFHLENBQ2hELGFBQXFCLEVBQ3JCLFVBQXVDLEVBQ2pDLEVBQUU7SUFDUixJQUFJLFFBQVEsR0FBRyw2QkFBNkIsQ0FBQyxHQUFHLENBQUMsYUFBYSxDQUFDLENBQUM7SUFDaEUsSUFBSSxDQUFDLFFBQVEsRUFBRSxDQUFDO1FBQ2QsUUFBUSxHQUFHLElBQUksR0FBRyxFQUFFLENBQUM7UUFDckIsNkJBQTZCLENBQUMsR0FBRyxDQUFDLGFBQWEsRUFBRSxRQUFRLENBQUMsQ0FBQztJQUM3RCxDQUFDO0lBQ0QsUUFBUSxDQUFDLEdBQUcsQ0FBQyxVQUFVLENBQUMsQ0FBQztBQUMzQixDQUFDLENBQUM7QUFFRixNQUFNLENBQUMsTUFBTSx5QkFBeUIsR0FBRyxDQUFDLGFBQXFCLEVBQVEsRUFBRTtJQUN2RSxLQUFLLE1BQU0sT0FBTyxJQUFJLDZCQUE2QixDQUFDLEdBQUcsQ0FBQyxhQUFhLENBQUMsSUFBSSxFQUFFLEVBQUUsQ0FBQztRQUM3RSxPQUFPLEVBQUUsQ0FBQztJQUNaLENBQUM7QUFDSCxDQUFDLENBQUMifQ==

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

@@ -0,0 +1,34 @@
+import type * as plugins from './plugins.js';
+import type { INormalizedCollectionModelSchema } from './classes.collection.js';
+export interface ISmartdataCollectionPreparationOptions {
+    /** Observe an exact topology, or install only missing declarations. */
+    mode: 'requireExact' | 'ensureCompatible';
+    /** Total budget including queueing and cursor cleanup: 1 through 120000 ms. */
+    timeoutMs: number;
+    signal?: AbortSignal;
+}
+/** @internal Validate before resolving a model manager or starting a deadline. */
+export declare const validateCollectionPreparationOptions: (opts: ISmartdataCollectionPreparationOptions) => void;
+/** @internal Owns the explicit preparation caller's deadline and queue wait. */
+export declare class CollectionPreparationBudget {
+    readonly signal: AbortSignal;
+    readonly mode: ISmartdataCollectionPreparationOptions['mode'];
+    private readonly deadline;
+    private readonly expiresAt;
+    private readonly timer;
+    constructor(opts: ISmartdataCollectionPreparationOptions);
+    private expire;
+    check(): void;
+    operationOptions(): {
+        timeoutMS: number;
+    };
+    /** Cleanup still runs after expiration; zero would disable the driver's timeout. */
+    cleanupOptions(): {
+        timeoutMS: number;
+    };
+    /** Cancellation detaches only this waiter, never the operation it is waiting for. */
+    waitFor(operationArg: Promise<void>): Promise<void>;
+    close(): void;
+}
+/** @internal No state is published until all commands and cleanup have settled. */
+export declare const prepareBoundCollection: (dbArg: plugins.mongodb.Db, schemaArg: INormalizedCollectionModelSchema, budgetArg: CollectionPreparationBudget, assertCurrentArg: () => void) => Promise<plugins.mongodb.Collection>;

package/dist_ts/nosqldb/classes.collectionpreparation.js

@@ -0,0 +1,134 @@
+import { SmartdataPersistenceError } from './classes.persistence.js';
+import { readBoundedInspectionCursor } from './classes.namespaceinspection.js';
+import { getExpectedCollectionTopologyForSchema, inspectCollectionTopologySnapshot, } from './classes.collectiontopology.js';
+/** @internal Validate before resolving a model manager or starting a deadline. */
+export const validateCollectionPreparationOptions = (opts) => {
+    if (!opts || Object.getPrototypeOf(opts) !== Object.prototype ||
+        Reflect.ownKeys(opts).some((keyArg) => typeof keyArg !== 'string' ||
+            !['mode', 'timeoutMs', 'signal'].includes(keyArg) ||
+            !('value' in Object.getOwnPropertyDescriptor(opts, keyArg))) ||
+        !['requireExact', 'ensureCompatible'].includes(opts.mode) ||
+        !Number.isSafeInteger(opts.timeoutMs) || opts.timeoutMs < 1 || opts.timeoutMs > 120_000 ||
+        (opts.signal !== undefined && !(opts.signal instanceof AbortSignal))) {
+        throw new SmartdataPersistenceError('invalid_argument', 'Invalid collection preparation options.');
+    }
+    opts.signal?.throwIfAborted();
+};
+/** @internal Owns the explicit preparation caller's deadline and queue wait. */
+export class CollectionPreparationBudget {
+    signal;
+    mode;
+    deadline = new AbortController();
+    expiresAt;
+    timer;
+    constructor(opts) {
+        validateCollectionPreparationOptions(opts);
+        this.mode = opts.mode;
+        this.expiresAt = performance.now() + opts.timeoutMs;
+        this.timer = setTimeout(() => this.expire(), opts.timeoutMs);
+        this.signal = opts.signal ? AbortSignal.any([opts.signal, this.deadline.signal]) : this.deadline.signal;
+    }
+    expire() {
+        this.deadline.abort(new SmartdataPersistenceError('unsupported_operation', 'Collection preparation deadline exceeded.'));
+    }
+    check() {
+        if (performance.now() >= this.expiresAt)
+            this.expire();
+        this.signal.throwIfAborted();
+    }
+    operationOptions() {
+        this.check();
+        return this.cleanupOptions();
+    }
+    /** Cleanup still runs after expiration; zero would disable the driver's timeout. */
+    cleanupOptions() {
+        return { timeoutMS: Math.max(1, Math.ceil(this.expiresAt - performance.now())) };
+    }
+    /** Cancellation detaches only this waiter, never the operation it is waiting for. */
+    async waitFor(operationArg) {
+        this.check();
+        await new Promise((resolveArg, rejectArg) => {
+            const onAbort = () => { cleanup(); rejectArg(this.signal.reason); };
+            const cleanup = () => this.signal.removeEventListener('abort', onAbort);
+            this.signal.addEventListener('abort', onAbort, { once: true });
+            operationArg.then(() => { cleanup(); resolveArg(); }, () => { cleanup(); resolveArg(); });
+            if (this.signal.aborted)
+                onAbort();
+        });
+        this.check();
+    }
+    close() { clearTimeout(this.timer); }
+}
+/** @internal No state is published until all commands and cleanup have settled. */
+export const prepareBoundCollection = async (dbArg, schemaArg, budgetArg, assertCurrentArg) => {
+    const expected = getExpectedCollectionTopologyForSchema(schemaArg);
+    const collection = dbArg.collection(schemaArg.collectionName);
+    const check = () => { budgetArg.check(); assertCurrentArg(); };
+    const inspect = async () => {
+        check();
+        const namespaces = await readBoundedInspectionCursor(dbArg.listCollections({ name: schemaArg.collectionName }, { nameOnly: false, batchSize: 1, ...budgetArg.operationOptions(), signal: budgetArg.signal }), 1, budgetArg.signal, () => budgetArg.cleanupOptions());
+        check();
+        const namespace = namespaces[0];
+        const indexes = namespace?.type === 'collection'
+            ? await readBoundedInspectionCursor(collection.listIndexes({
+                batchSize: 1, ...budgetArg.operationOptions(),
+            }), 64, budgetArg.signal, () => budgetArg.cleanupOptions())
+            : [];
+        check();
+        return inspectCollectionTopologySnapshot(expected, { namespace: namespace ?? null, indexes });
+    };
+    const requireAcceptable = (inspectionArg, exactArg) => {
+        if (inspectionArg.status === 'divergent' || (exactArg && inspectionArg.status !== 'exact')) {
+            throw new SmartdataPersistenceError('invalid_configuration', `Collection "${schemaArg.collectionName}" requires ${exactArg ? 'exact' : 'compatible'} topology: ` +
+                `${inspectionArg.status}${inspectionArg.reasonCodes.length ? ` (${inspectionArg.reasonCodes.join(', ')})` : ''}.`);
+        }
+    };
+    let inspection = await inspect();
+    requireAcceptable(inspection, budgetArg.mode === 'requireExact');
+    if (budgetArg.mode === 'ensureCompatible' && inspection.status !== 'exact') {
+        if (inspection.status === 'absent') {
+            check();
+            try {
+                await dbArg.createCollection(schemaArg.collectionName, budgetArg.operationOptions());
+            }
+            catch (errorArg) {
+                if (errorArg?.code !== 48)
+                    throw errorArg;
+            }
+            // A competing creator may have installed divergent options or indexes.
+            inspection = await inspect();
+            requireAcceptable(inspection, false);
+            if (inspection.status === 'absent') {
+                throw new SmartdataPersistenceError('unsupported_operation', 'Created collection is not observable.');
+            }
+        }
+        const existing = new Set(inspection.actualIndexes.map((indexArg) => indexArg.name));
+        for (const index of schemaArg.indexes) {
+            if (existing.has(index.name))
+                continue;
+            check();
+            try {
+                await collection.createIndex(Object.fromEntries(index.key), {
+                    ...index.options, name: index.name, ...budgetArg.operationOptions(),
+                });
+            }
+            catch (errorArg) {
+                // A rejected acknowledgement does not prove the index build failed.
+                // Continue only from compatible observed topology containing this exact
+                // declaration, within the same deadline and connection generation.
+                inspection = await inspect();
+                requireAcceptable(inspection, false);
+                if (!inspection.actualIndexes.some((actualArg) => actualArg.name === index.name)) {
+                    throw errorArg;
+                }
+                for (const actual of inspection.actualIndexes)
+                    existing.add(actual.name);
+            }
+        }
+        inspection = await inspect();
+        requireAcceptable(inspection, true);
+    }
+    check();
+    return collection;
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jb2xsZWN0aW9ucHJlcGFyYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9ub3NxbGRiL2NsYXNzZXMuY29sbGVjdGlvbnByZXBhcmF0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE9BQU8sRUFBRSx5QkFBeUIsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQ3JFLE9BQU8sRUFBRSwyQkFBMkIsRUFBRSxNQUFNLGtDQUFrQyxDQUFDO0FBQy9FLE9BQU8sRUFDTCxzQ0FBc0MsRUFDdEMsaUNBQWlDLEdBQ2xDLE1BQU0saUNBQWlDLENBQUM7QUFVekMsa0ZBQWtGO0FBQ2xGLE1BQU0sQ0FBQyxNQUFNLG9DQUFvQyxHQUFHLENBQUMsSUFBNEMsRUFBUSxFQUFFO0lBQ3pHLElBQUksQ0FBQyxJQUFJLElBQUksTUFBTSxDQUFDLGNBQWMsQ0FBQyxJQUFJLENBQUMsS0FBSyxNQUFNLENBQUMsU0FBUztRQUMzRCxPQUFPLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsT0FBTyxNQUFNLEtBQUssUUFBUTtZQUMvRCxDQUFDLENBQUMsTUFBTSxFQUFFLFdBQVcsRUFBRSxRQUFRLENBQUMsQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDO1lBQ2pELENBQUMsQ0FBQyxPQUFPLElBQUksTUFBTSxDQUFDLHdCQUF3QixDQUFDLElBQUksRUFBRSxNQUFNLENBQUUsQ0FBQyxDQUFDO1FBQy9ELENBQUMsQ0FBQyxjQUFjLEVBQUUsa0JBQWtCLENBQUMsQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQztRQUN6RCxDQUFDLE1BQU0sQ0FBQyxhQUFhLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxJQUFJLElBQUksQ0FBQyxTQUFTLEdBQUcsQ0FBQyxJQUFJLElBQUksQ0FBQyxTQUFTLEdBQUcsT0FBTztRQUN2RixDQUFDLElBQUksQ0FBQyxN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

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

@@ -0,0 +1,47 @@
+import type { INormalizedCollectionModelSchema } from './classes.collection.js';
+import type { SmartdataDb } from './classes.db.js';
+export type TSmartdataCollectionTopologyStatus = 'absent' | 'compatible' | 'exact' | 'divergent';
+export type TSmartdataCollectionTopologyReasonCode = 'namespace_not_collection' | 'collection_options_present' | 'id_index_missing' | 'id_index_changed' | 'expected_index_missing' | 'unexpected_index' | 'index_changed' | 'unsupported_actual_index';
+export type TSmartdataCollectionTopologyIndexDirection = 1 | -1 | 'text';
+export interface ISmartdataCollectionTopologyIndexKey {
+    readonly path: string;
+    readonly direction: TSmartdataCollectionTopologyIndexDirection;
+    readonly weight: number | null;
+}
+export interface ISmartdataCollectionTopologyIndex {
+    readonly name: string;
+    readonly keys: readonly ISmartdataCollectionTopologyIndexKey[];
+    readonly unique: boolean;
+    readonly sparse: boolean;
+    readonly expireAfterSeconds: number | null;
+}
+export interface ISmartdataExpectedCollectionTopology {
+    readonly collectionName: string;
+    readonly indexes: readonly ISmartdataCollectionTopologyIndex[];
+}
+export interface ISmartdataCollectionTopologyInspection {
+    readonly collectionName: string;
+    readonly status: TSmartdataCollectionTopologyStatus;
+    readonly reasonCodes: readonly TSmartdataCollectionTopologyReasonCode[];
+    readonly expectedIndexes: readonly ISmartdataCollectionTopologyIndex[];
+    readonly actualIndexes: readonly ISmartdataCollectionTopologyIndex[];
+}
+type TCollectionModelSchemaResolver = () => INormalizedCollectionModelSchema;
+export declare const collectionModelSchemaResolverSymbol: unique symbol;
+export declare const collectionTopologyDbInspectionSymbol: unique symbol;
+interface ICollectionTopologyModelConstructor {
+    readonly name: string;
+    readonly [collectionModelSchemaResolverSymbol]?: TCollectionModelSchemaResolver;
+}
+interface ICollectionTopologyRawSnapshot {
+    namespace: Record<string, unknown> | null;
+    indexes: unknown[];
+}
+export declare const compareSmartdataTopologyStrings: (leftArg: string, rightArg: string) => number;
+export declare const getExpectedCollectionTopologyForModel: (constructorArg: ICollectionTopologyModelConstructor) => ISmartdataExpectedCollectionTopology;
+/** @internal Normalizes the same contract for a bound collection. */
+export declare const getExpectedCollectionTopologyForSchema: (schema: INormalizedCollectionModelSchema) => ISmartdataExpectedCollectionTopology;
+export declare const inspectCollectionTopologyForModel: (constructorArg: ICollectionTopologyModelConstructor, dbArg: SmartdataDb) => Promise<ISmartdataCollectionTopologyInspection>;
+/** @internal Pure normalization shared by model and namespace inspection. */
+export declare const inspectCollectionTopologySnapshot: (expected: ISmartdataExpectedCollectionTopology, rawSnapshot: ICollectionTopologyRawSnapshot) => ISmartdataCollectionTopologyInspection;
+export {};