@lossless.org/client 0.1.0

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

@@ -0,0 +1,73 @@
+import type { SmartdataDb } from './classes.db.js';
+export interface ISmartdataMongoOperationOptions {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface ISmartdataMongoReplicaSetExpectation extends ISmartdataMongoOperationOptions {
+    expectedSetName: string;
+    expectedMemberHost: string;
+}
+export interface ISmartdataMongoReplicaSetMember {
+    host: string;
+    health: number;
+    state: string;
+}
+export type TSmartdataMongoReplicaSetState = 'replication_disabled' | 'uninitialized' | 'exact_primary' | 'exact_non_primary' | 'divergent' | 'unavailable';
+export interface ISmartdataMongoReplicaSetInspection {
+    state: TSmartdataMongoReplicaSetState;
+    durationMs: number;
+    observedSetName?: string;
+    observedMembers?: ISmartdataMongoReplicaSetMember[];
+}
+export interface ISmartdataMongoReplicaSetInitializationResult {
+    status: 'initiated' | 'already_configured';
+    topology: ISmartdataMongoReplicaSetInspection;
+}
+export type TSmartdataMongoTransactionReadinessFailureReason = 'aborted' | 'timeout' | 'unsupported_topology' | 'unavailable' | 'cleanup_failed';
+export type TSmartdataMongoTransactionReadinessResult = {
+    ready: true;
+    status: 'ready';
+    durationMs: number;
+} | {
+    ready: false;
+    status: 'unavailable';
+    reason: TSmartdataMongoTransactionReadinessFailureReason;
+    durationMs: number;
+};
+export interface ISmartdataMongoDatabaseUserOptions extends ISmartdataMongoOperationOptions {
+    expectedDatabaseName: string;
+    username: string;
+    password: string;
+}
+export interface ISmartdataMongoDatabaseUserRemovalOptions extends ISmartdataMongoOperationOptions {
+    expectedDatabaseName: string;
+    username: string;
+}
+export interface ISmartdataMongoDatabaseDropOptions extends ISmartdataMongoOperationOptions {
+    expectedDatabaseName: string;
+    confirmationDatabaseName: string;
+}
+export declare class SmartdataMongoAdministration {
+    private readonly owner;
+    private readonly expectedMongoDb;
+    private readonly expectedMongoDbClient;
+    constructor(ownerArg: SmartdataDb);
+    inspectReplicaSet(optionsArg: ISmartdataMongoReplicaSetExpectation): Promise<ISmartdataMongoReplicaSetInspection>;
+    initializeSingleMemberReplicaSet(optionsArg: ISmartdataMongoReplicaSetExpectation): Promise<ISmartdataMongoReplicaSetInitializationResult>;
+    checkTransactionReadiness(optionsArg?: ISmartdataMongoOperationOptions): Promise<TSmartdataMongoTransactionReadinessResult>;
+    ensureReadWriteDatabaseUser(optionsArg: ISmartdataMongoDatabaseUserOptions): Promise<{
+        status: 'created' | 'updated';
+    }>;
+    removeDatabaseUser(optionsArg: ISmartdataMongoDatabaseUserRemovalOptions): Promise<{
+        removed: boolean;
+    }>;
+    dropDatabase(optionsArg: ISmartdataMongoDatabaseDropOptions): Promise<{
+        dropped: boolean;
+    }>;
+    private getConnectedContext;
+    private contextIsCurrent;
+    private createTopologyResult;
+    private assertDatabaseUserOptions;
+    private runAdministrationCommand;
+    private executeAdministrationCommand;
+}

package/dist_ts/nosqldb/classes.mongoadministration.js

@@ -0,0 +1,497 @@
+import * as plugins from './plugins.js';
+import { SmartdataPersistenceError } from './classes.persistence.js';
+const mongoAdministrationDefaultTimeoutMs = 5_000;
+const mongoAdministrationMaximumTimeoutMs = 30_000;
+const transactionCapabilityCollectionName = '__smartdata_transaction_capability';
+const replicaSetNameRegex = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+const replicaSetMemberRegex = /^([A-Za-z0-9][A-Za-z0-9.-]{0,252}):([0-9]{1,5})$/;
+const databaseNameRegex = /^[^/\\.\s"$*<>:|?\u0000]{1,63}$/;
+const databaseUsernameRegex = /^[^\u0000\r\n]{1,128}$/;
+const assertExactDataObject = (valueArg, expectedKeysArg, descriptionArg) => {
+    if (valueArg === null
+        || typeof valueArg !== 'object'
+        || Array.isArray(valueArg)
+        || Object.getPrototypeOf(valueArg) !== Object.prototype) {
+        throw new SmartdataPersistenceError('invalid_argument', `${descriptionArg} must be a plain object.`);
+    }
+    const keys = Reflect.ownKeys(valueArg);
+    if (keys.some((keyArg) => (typeof keyArg !== 'string' || !expectedKeysArg.includes(keyArg)))) {
+        throw new SmartdataPersistenceError('invalid_argument', `${descriptionArg} has an invalid shape.`);
+    }
+    for (const key of keys) {
+        const descriptor = Object.getOwnPropertyDescriptor(valueArg, key);
+        if (!descriptor || !('value' in descriptor)) {
+            throw new SmartdataPersistenceError('invalid_argument', `${descriptionArg} must contain data properties only.`);
+        }
+    }
+    return valueArg;
+};
+const isAbortSignal = (valueArg) => (valueArg !== null
+    && typeof valueArg === 'object'
+    && typeof valueArg.aborted === 'boolean'
+    && typeof valueArg.addEventListener === 'function');
+const assertOperationOptions = (optionsArg) => {
+    const timeoutMs = optionsArg.timeoutMs ?? mongoAdministrationDefaultTimeoutMs;
+    if (!Number.isSafeInteger(timeoutMs)
+        || timeoutMs <= 0
+        || timeoutMs > mongoAdministrationMaximumTimeoutMs) {
+        throw new SmartdataPersistenceError('invalid_argument', `Mongo administration timeoutMs must be a positive safe integer no greater than ${mongoAdministrationMaximumTimeoutMs}.`);
+    }
+    if (optionsArg.signal !== undefined && !isAbortSignal(optionsArg.signal)) {
+        throw new SmartdataPersistenceError('invalid_argument', 'Mongo administration signal must be an AbortSignal.');
+    }
+    return {
+        timeoutMs: timeoutMs,
+        signal: optionsArg.signal,
+    };
+};
+const assertReplicaSetExpectation = (optionsArg) => {
+    const options = assertExactDataObject(optionsArg, ['expectedSetName', 'expectedMemberHost', 'timeoutMs', 'signal'], 'Mongo replica-set expectation');
+    if (typeof options.expectedSetName !== 'string'
+        || !replicaSetNameRegex.test(options.expectedSetName)) {
+        throw new SmartdataPersistenceError('invalid_argument', 'Mongo expectedSetName must be a canonical replica-set name.');
+    }
+    if (typeof options.expectedMemberHost !== 'string') {
+        throw new SmartdataPersistenceError('invalid_argument', 'Mongo expectedMemberHost must be a canonical hostname and port.');
+    }
+    const memberMatch = replicaSetMemberRegex.exec(options.expectedMemberHost);
+    const port = memberMatch ? Number(memberMatch[2]) : 0;
+    if (!memberMatch || port < 1 || port > 65_535) {
+        throw new SmartdataPersistenceError('invalid_argument', 'Mongo expectedMemberHost must be a canonical hostname and port.');
+    }
+    return {
+        expectedSetName: options.expectedSetName,
+        expectedMemberHost: options.expectedMemberHost,
+        ...assertOperationOptions(options),
+    };
+};
+const isMongoServerError = (errorArg, codeArg, codeNameArg) => errorArg instanceof plugins.mongodb.MongoServerError
+    && (errorArg.code === codeArg || errorArg.codeName === codeNameArg);
+const isMongoTimeoutError = (errorArg) => (errorArg instanceof plugins.mongodb.MongoOperationTimeoutError);
+const isUnsupportedTransactionTopologyError = (errorArg) => (isMongoServerError(errorArg, 20, 'IllegalOperation')
+    || isMongoServerError(errorArg, 263, 'OperationNotSupportedInTransaction'));
+const isUserAlreadyExistsError = (errorArg) => (isMongoServerError(errorArg, 51_003, 'UserAlreadyExists')
+    || isMongoServerError(errorArg, 51_003, 'Location51003'));
+const isUserNotFoundError = (errorArg) => (isMongoServerError(errorArg, 11, 'UserNotFound'));
+export class SmartdataMongoAdministration {
+    owner;
+    expectedMongoDb;
+    expectedMongoDbClient;
+    constructor(ownerArg) {
+        if (ownerArg.status !== 'connected'
+            || !ownerArg.mongoDb
+            || !ownerArg.mongoDbClient
+            || ownerArg.mongoDb.client !== ownerArg.mongoDbClient) {
+            throw new SmartdataPersistenceError('unsupported_operation', 'Mongo administration requires a connected SmartData database.');
+        }
+        this.owner = ownerArg;
+        this.expectedMongoDb = ownerArg.mongoDb;
+        this.expectedMongoDbClient = ownerArg.mongoDbClient;
+    }
+    async inspectReplicaSet(optionsArg) {
+        const options = assertReplicaSetExpectation(optionsArg);
+        const startedAt = performance.now();
+        const context = this.getConnectedContext();
+        if (options.signal?.aborted) {
+            return {
+                state: 'unavailable',
+                durationMs: performance.now() - startedAt,
+            };
+        }
+        let status;
+        try {
+            status = await context.mongoDb.admin().command({ replSetGetStatus: 1 }, {
+                timeoutMS: options.timeoutMs,
+                signal: options.signal,
+            });
+        }
+        catch (errorArg) {
+            if (!this.contextIsCurrent(context)) {
+                return this.createTopologyResult('unavailable', startedAt);
+            }
+            if (isMongoServerError(errorArg, 76, 'NoReplicationEnabled')) {
+                return this.createTopologyResult('replication_disabled', startedAt);
+            }
+            if (isMongoServerError(errorArg, 94, 'NotYetInitialized')) {
+                return this.createTopologyResult('uninitialized', startedAt);
+            }
+            return this.createTopologyResult('unavailable', startedAt);
+        }
+        if (!this.contextIsCurrent(context)) {
+            return this.createTopologyResult('unavailable', startedAt);
+        }
+        const observedSetName = typeof status.set === 'string' ? status.set : undefined;
+        const rawMembers = Array.isArray(status.members) ? status.members : [];
+        const observedMembers = [];
+        let membersWellFormed = Array.isArray(status.members);
+        for (const memberArg of rawMembers) {
+            if (!memberArg || typeof memberArg !== 'object' || Array.isArray(memberArg)) {
+                membersWellFormed = false;
+                continue;
+            }
+            const member = memberArg;
+            if (typeof member.name !== 'string'
+                || typeof member.stateStr !== 'string'
+                || typeof member.health !== 'number'
+                || !Number.isFinite(member.health)) {
+                membersWellFormed = false;
+                continue;
+            }
+            observedMembers.push({
+                host: member.name,
+                health: member.health,
+                state: member.stateStr,
+            });
+        }
+        const exactConfiguration = membersWellFormed
+            && rawMembers.length === observedMembers.length
+            && observedSetName === options.expectedSetName
+            && observedMembers.length === 1
+            && observedMembers[0].host === options.expectedMemberHost;
+        if (!exactConfiguration) {
+            return {
+                state: 'divergent',
+                observedSetName,
+                observedMembers,
+                durationMs: performance.now() - startedAt,
+            };
+        }
+        const exactPrimary = status.myState === 1
+            && observedMembers[0].state === 'PRIMARY'
+            && observedMembers[0].health === 1;
+        return {
+            state: exactPrimary ? 'exact_primary' : 'exact_non_primary',
+            observedSetName,
+            observedMembers,
+            durationMs: performance.now() - startedAt,
+        };
+    }
+    async initializeSingleMemberReplicaSet(optionsArg) {
+        const options = assertReplicaSetExpectation(optionsArg);
+        const topology = await this.inspectReplicaSet(options);
+        if (topology.state === 'exact_primary' || topology.state === 'exact_non_primary') {
+            return {
+                status: 'already_configured',
+                topology,
+            };
+        }
+        if (topology.state === 'divergent') {
+            throw new SmartdataPersistenceError('invalid_configuration', 'Mongo replica-set configuration differs from the exact expected topology.');
+        }
+        if (topology.state === 'replication_disabled') {
+            throw new SmartdataPersistenceError('invalid_configuration', 'Mongo replication must be enabled before replica-set initialization.');
+        }
+        if (topology.state !== 'uninitialized') {
+            throw new SmartdataPersistenceError('unsupported_operation', 'Mongo replica-set topology is unavailable for initialization.');
+        }
+        const context = this.getConnectedContext();
+        let initializationStatus = 'initiated';
+        try {
+            const response = await context.mongoDb.admin().command({
+                replSetInitiate: {
+                    _id: options.expectedSetName,
+                    members: [{
+                            _id: 0,
+                            host: options.expectedMemberHost,
+                        }],
+                },
+            }, {
+                timeoutMS: options.timeoutMs,
+                signal: options.signal,
+            });
+            if (response.ok !== 1 || !this.contextIsCurrent(context)) {
+                throw new SmartdataPersistenceError('unsupported_operation', 'Mongo did not acknowledge replica-set initialization.');
+            }
+        }
+        catch (errorArg) {
+            if (isMongoServerError(errorArg, 23, 'AlreadyInitialized')) {
+                initializationStatus = 'already_configured';
+            }
+            else {
+                if (errorArg instanceof SmartdataPersistenceError)
+                    throw errorArg;
+                throw new SmartdataPersistenceError('unsupported_operation', 'Mongo replica-set initialization failed.');
+            }
+        }
+        const initializedTopology = await this.inspectReplicaSet(options);
+        if (initializedTopology.state === 'divergent') {
+            throw new SmartdataPersistenceError('invalid_configuration', 'Mongo initialized a replica-set topology that differs from the expectation.');
+        }
+        if (initializedTopology.state !== 'exact_primary'
+            && initializedTopology.state !== 'exact_non_primary') {
+            throw new SmartdataPersistenceError('unsupported_operation', 'Mongo replica-set initialization could not prove the exact expected topology.');
+        }
+        return {
+            status: initializationStatus,
+            topology: initializedTopology,
+        };
+    }
+    async checkTransactionReadiness(optionsArg = {}) {
+        const options = assertExactDataObject(optionsArg, ['timeoutMs', 'signal'], 'Mongo transaction-readiness options');
+        const boundedOptions = assertOperationOptions(options);
+        const startedAt = performance.now();
+        const context = this.getConnectedContext();
+        const probeId = globalThis.crypto.randomUUID();
+        const collection = context.mongoDb.collection(transactionCapabilityCollectionName);
+        let session;
+        let failure;
+        let cleanupFailed = false;
+        try {
+            try {
+                await context.mongoDb.command({ create: transactionCapabilityCollectionName }, {
+                    timeoutMS: boundedOptions.timeoutMs,
+                    signal: boundedOptions.signal,
+                });
+            }
+            catch (errorArg) {
+                if (!isMongoServerError(errorArg, 48, 'NamespaceExists'))
+                    throw errorArg;
+            }
+            session = context.mongoDbClient.startSession();
+            session.startTransaction({
+                readConcern: { level: 'snapshot' },
+                writeConcern: { w: 'majority' },
+            });
+            const insertResponse = await context.mongoDb.command({
+                insert: transactionCapabilityCollectionName,
+                documents: [
+                    { _id: `${probeId}:1`, probeId, part: 1 },
+                    { _id: `${probeId}:2`, probeId, part: 2 },
+                ],
+                ordered: true,
+            }, {
+                session,
+                timeoutMS: boundedOptions.timeoutMs,
+                signal: boundedOptions.signal,
+            });
+            if (insertResponse.ok !== 1 || insertResponse.n !== 2) {
+                throw new SmartdataPersistenceError('unsupported_operation', 'Mongo transaction probe did not acknowledge both writes.');
+            }
+            const abortResponse = await context.mongoDb.admin().command({
+                abortTransaction: 1,
+                writeConcern: {
+                    w: 'majority',
+                    wtimeout: boundedOptions.timeoutMs,
+                },
+            }, {
+                session,
+                timeoutMS: boundedOptions.timeoutMs,
+                signal: boundedOptions.signal,
+            });
+            if (abortResponse.ok !== 1 || !this.contextIsCurrent(context)) {
+                throw new SmartdataPersistenceError('unsupported_operation', 'Mongo transaction probe did not acknowledge its abort.');
+            }
+            // The acknowledged raw command proves the server-side abort. Calling the
+            // public driver method afterwards advances its local transaction state;
+            // that method intentionally ignores most server-side abort errors.
+            await session.abortTransaction({ timeoutMS: boundedOptions.timeoutMs });
+            const remainingCount = await collection.countDocuments({ probeId }, {
+                limit: 2,
+                timeoutMS: boundedOptions.timeoutMs,
+                signal: boundedOptions.signal,
+            });
+            if (remainingCount !== 0 || !this.contextIsCurrent(context)) {
+                cleanupFailed = remainingCount !== 0;
+                throw new SmartdataPersistenceError('unsupported_operation', 'Mongo transaction probe did not abort cleanly.');
+            }
+            return {
+                ready: true,
+                status: 'ready',
+                durationMs: performance.now() - startedAt,
+            };
+        }
+        catch (errorArg) {
+            failure = errorArg;
+            if (session?.inTransaction()) {
+                try {
+                    await session.abortTransaction({ timeoutMS: boundedOptions.timeoutMs });
+                }
+                catch {
+                    cleanupFailed = true;
+                }
+            }
+            try {
+                await collection.deleteMany({ probeId }, { timeoutMS: boundedOptions.timeoutMs });
+            }
+            catch {
+                cleanupFailed = true;
+            }
+        }
+        finally {
+            await session?.endSession().catch(() => undefined);
+        }
+        let reason;
+        if (cleanupFailed) {
+            reason = 'cleanup_failed';
+        }
+        else if (boundedOptions.signal?.aborted) {
+            reason = 'aborted';
+        }
+        else if (isMongoTimeoutError(failure)) {
+            reason = 'timeout';
+        }
+        else if (isUnsupportedTransactionTopologyError(failure)) {
+            reason = 'unsupported_topology';
+        }
+        else {
+            reason = 'unavailable';
+        }
+        return {
+            ready: false,
+            status: 'unavailable',
+            reason,
+            durationMs: performance.now() - startedAt,
+        };
+    }
+    async ensureReadWriteDatabaseUser(optionsArg) {
+        const options = this.assertDatabaseUserOptions(optionsArg, true);
+        const context = this.getConnectedContext(options.expectedDatabaseName);
+        const usersInfo = await this.runAdministrationCommand(context, {
+            usersInfo: {
+                user: options.username,
+                db: options.expectedDatabaseName,
+            },
+        }, options, 'Mongo database-user inspection failed.');
+        if (!Array.isArray(usersInfo.users) || usersInfo.users.length > 1) {
+            throw new SmartdataPersistenceError('unsupported_operation', 'Mongo database-user inspection returned an invalid result.');
+        }
+        const updateCommand = {
+            updateUser: options.username,
+            pwd: options.password,
+            roles: [{ role: 'readWrite', db: options.expectedDatabaseName }],
+        };
+        if (usersInfo.users.length === 1) {
+            await this.runAdministrationCommand(context, updateCommand, options, 'Mongo database-user reconciliation failed.');
+            return { status: 'updated' };
+        }
+        try {
+            await this.executeAdministrationCommand(context, {
+                createUser: options.username,
+                pwd: options.password,
+                roles: [{ role: 'readWrite', db: options.expectedDatabaseName }],
+            }, options);
+            return { status: 'created' };
+        }
+        catch (errorArg) {
+            if (!isUserAlreadyExistsError(errorArg)) {
+                throw new SmartdataPersistenceError('unsupported_operation', 'Mongo database-user reconciliation failed.');
+            }
+        }
+        await this.runAdministrationCommand(context, updateCommand, options, 'Mongo database-user reconciliation failed.');
+        return { status: 'updated' };
+    }
+    async removeDatabaseUser(optionsArg) {
+        const options = this.assertDatabaseUserOptions(optionsArg, false);
+        const context = this.getConnectedContext(options.expectedDatabaseName);
+        const usersInfo = await this.runAdministrationCommand(context, {
+            usersInfo: {
+                user: options.username,
+                db: options.expectedDatabaseName,
+            },
+        }, options, 'Mongo database-user inspection failed.');
+        if (!Array.isArray(usersInfo.users) || usersInfo.users.length > 1) {
+            throw new SmartdataPersistenceError('unsupported_operation', 'Mongo database-user inspection returned an invalid result.');
+        }
+        if (usersInfo.users.length === 0)
+            return { removed: false };
+        try {
+            await this.executeAdministrationCommand(context, { dropUser: options.username }, options);
+        }
+        catch (errorArg) {
+            if (isUserNotFoundError(errorArg))
+                return { removed: false };
+            throw new SmartdataPersistenceError('unsupported_operation', 'Mongo database-user removal failed.');
+        }
+        return { removed: true };
+    }
+    async dropDatabase(optionsArg) {
+        const options = assertExactDataObject(optionsArg, ['expectedDatabaseName', 'confirmationDatabaseName', 'timeoutMs', 'signal'], 'Mongo database-drop options');
+        if (typeof options.expectedDatabaseName !== 'string'
+            || !databaseNameRegex.test(options.expectedDatabaseName)) {
+            throw new SmartdataPersistenceError('invalid_argument', 'Mongo expectedDatabaseName must be a canonical database name.');
+        }
+        if (options.confirmationDatabaseName !== options.expectedDatabaseName
+            || ['admin', 'config', 'local'].includes(options.expectedDatabaseName)) {
+            throw new SmartdataPersistenceError('invalid_argument', 'Mongo database-drop confirmation must exactly match a non-system database.');
+        }
+        const context = this.getConnectedContext(options.expectedDatabaseName);
+        await this.runAdministrationCommand(context, { dropDatabase: 1 }, assertOperationOptions(options), 'Mongo database removal failed.');
+        return { dropped: true };
+    }
+    getConnectedContext(expectedDatabaseNameArg) {
+        if (this.owner.status !== 'connected'
+            || !this.owner.mongoDb
+            || !this.owner.mongoDbClient
+            || this.owner.mongoDb.client !== this.owner.mongoDbClient
+            || this.owner.mongoDb !== this.expectedMongoDb
+            || this.owner.mongoDbClient !== this.expectedMongoDbClient) {
+            throw new SmartdataPersistenceError('unsupported_operation', 'Mongo administration requires a connected SmartData database.');
+        }
+        if (expectedDatabaseNameArg !== undefined
+            && (this.owner.mongoDb.databaseName !== expectedDatabaseNameArg
+                || this.owner.smartdataOptions.mongoDbName !== expectedDatabaseNameArg)) {
+            throw new SmartdataPersistenceError('invalid_configuration', 'Mongo expectedDatabaseName does not match the connected database.');
+        }
+        return {
+            mongoDb: this.owner.mongoDb,
+            mongoDbClient: this.owner.mongoDbClient,
+        };
+    }
+    contextIsCurrent(contextArg) {
+        return this.owner.status === 'connected'
+            && this.owner.mongoDb === contextArg.mongoDb
+            && this.owner.mongoDbClient === contextArg.mongoDbClient;
+    }
+    createTopologyResult(stateArg, startedAtArg) {
+        return {
+            state: stateArg,
+            durationMs: performance.now() - startedAtArg,
+        };
+    }
+    assertDatabaseUserOptions(optionsArg, hasPasswordArg) {
+        const allowedKeys = hasPasswordArg
+            ? ['expectedDatabaseName', 'username', 'password', 'timeoutMs', 'signal']
+            : ['expectedDatabaseName', 'username', 'timeoutMs', 'signal'];
+        const options = assertExactDataObject(optionsArg, allowedKeys, 'Mongo database-user options');
+        if (typeof options.expectedDatabaseName !== 'string'
+            || !databaseNameRegex.test(options.expectedDatabaseName)) {
+            throw new SmartdataPersistenceError('invalid_argument', 'Mongo expectedDatabaseName must be a canonical database name.');
+        }
+        if (typeof options.username !== 'string'
+            || !databaseUsernameRegex.test(options.username)) {
+            throw new SmartdataPersistenceError('invalid_argument', 'Mongo database username must be a bounded string without control characters.');
+        }
+        if (hasPasswordArg
+            && (typeof options.password !== 'string'
+                || options.password.length < 16
+                || options.password.length > 1024
+                || /[\u0000\r\n]/.test(options.password))) {
+            throw new SmartdataPersistenceError('invalid_argument', 'Mongo database-user password must be a bounded nonempty secret without control characters.');
+        }
+        return {
+            expectedDatabaseName: options.expectedDatabaseName,
+            username: options.username,
+            password: (hasPasswordArg ? options.password : undefined),
+            ...assertOperationOptions(options),
+        };
+    }
+    async runAdministrationCommand(contextArg, commandArg, optionsArg, failureMessageArg) {
+        try {
+            return await this.executeAdministrationCommand(contextArg, commandArg, optionsArg);
+        }
+        catch {
+            throw new SmartdataPersistenceError('unsupported_operation', failureMessageArg);
+        }
+    }
+    async executeAdministrationCommand(contextArg, commandArg, optionsArg) {
+        const response = await contextArg.mongoDb.command(commandArg, {
+            timeoutMS: optionsArg.timeoutMs,
+            signal: optionsArg.signal,
+        });
+        if (response.ok !== 1 || !this.contextIsCurrent(contextArg)) {
+            throw new Error('Mongo administration acknowledgement was unavailable.');
+        }
+        return response;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5tb25nb2FkbWluaXN0cmF0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvbm9zcWxkYi9jbGFzc2VzLm1vbmdvYWRtaW5pc3RyYXRpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFHeEMsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUE4RXJFLE1BQU0sbUNBQW1DLEdBQUcsS0FBSyxDQUFDO0FBQ2xELE1BQU0sbUNBQW1DLEdBQUcsTUFBTSxDQUFDO0FBQ25ELE1BQU0sbUNBQW1DLEdBQUcsb0NBQW9DLENBQUM7QUFRakYsTUFBTSxtQkFBbUIsR0FBRyxvQ0FBb0MsQ0FBQztBQUNqRSxNQUFNLHFCQUFxQixHQUFHLGtEQUFrRCxDQUFDO0FBQ2pGLE1BQU0saUJBQWlCLEdBQUcsaUNBQWlDLENBQUM7QUFDNUQsTUFBTSxxQkFBcUIsR0FBRyx3QkFBd0IsQ0FBQztBQUV2RCxNQUFNLHFCQUFxQixHQUFHLENBQzVCLFFBQWlCLEVBQ2pCLGVBQWtDLEVBQ2xDLGNBQXNCLEVBQ0csRUFBRTtJQUMzQixJQUNFLFFBQVEsS0FBSyxJQUFJO1dBQ2QsT0FBTyxRQUFRLEtBQUssUUFBUTtXQUM1QixLQUFLLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQztXQUN2QixNQUFNLENBQUMsY0FBYyxDQUFDLFFBQVEsQ0FBQyxLQUFLLE1BQU0sQ0FBQyxTQUFTLEVBQ3ZELENBQUM7UUFDRCxNQUFNLElBQUkseUJBQXlCLENBQ2pDLGtCQUFrQixFQUNsQixHQUFHLGNBQWMsMEJBQTBCLENBQzVDLENBQUM7SUFDSixDQUFDO0lBQ0QsTUFBTSxJQUFJLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUN2QyxJQUFJLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQyxNQUFNLEVBQUUsRUFBRSxDQUFDLENBQ3hCLE9BQU8sTUFBTSxLQUFLLFFBQVEsSUFBSSxDQUFDLGVBQWUsQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLENBQ2hFLENBQUMsRUFBRSxDQUFDO1FBQ0gsTUFBTSxJQUFJLHlCQUF5QixDQUNqQyxrQkFBa0IsRUFDbEIsR0FBRyxjQUFjLHdCQUF3QixDQUMxQyxDQUFDO0lBQ0osQ0FBQztJQUNELEtBQUssTUFBTSxHQUFHLElBQUksSUFBZ0IsRUFBRSxDQUFDO1FBQ25DLE1BQU0sVUFBVSxHQUFHLE1BQU0sQ0FBQyx3QkFBd0IsQ0FBQyxRQUFRLEVBQUUsR0FBRyxDQUFDLENBQUM7UUFDbEUsSUFBSSxDQUFDLFVBQVUsSUFBSSxDQUFDLENBQUMsT0FBTyxJQUFJLFVBQVUsQ0FBQyxFQUFFLENBQUM7WUFDNUMsTUFBTSxJQUFJLHlCQUF5QixDQUNqQyxrQkFBa0IsRUFDbEIsR0FBRyxjQUFjLHFDQUFxQyxDQUN2RCxDQUFDO1FBQ0osQ0FBQztJQUNILENBQUM7SUFDRCxPQUFPLFFBQW1DLENBQUM7QUFDN0MsQ0FBQyxDQUFDO0FBRUYsTUFBTSxhQUFhLEdBQUcsQ0FBQyxRQUFpQixFQUEyQixFQUFFLENBQUMsQ0FDcEUsUUFBUSxLQUFLLElBQUk7T0FDZCxPQUFPLFFBQVEsS0FBSyxRQUFRO09BQzVCLE9BQVEsUUFBd0IsQ0FBQyxPQUFPLEtBQUssU0FBUztPQUN0RCxPQUFRLFFBQXdCLENBQUMsZ0JBQWdCLEtBQUssVUFBVSxDQUNwRSxDQUFDO0FBRUYsTUFBTSxzQkFBc0IsR0FBRyxDQUM3QixVQUFtQyxFQUVhLEVBQUU7SUFDbEQsTUFBTSxTQUFTLEdBQUcsVUFBVSxDQUFDLFNBQVMsSUFBSSxtQ0FBbUMsQ0FBQztJQUM5RSxJQUNFLENBQUMsTUFBTSxDQUFDLGFBQWEsQ0FBQyxTQUFTLENBQUM7V0FDNUIsU0FBb0IsSUFBSSxDQUFDO1dBQ3pCLFNBQW9CLEdBQUcsbUNBQW1DLEVBQzlELENBQUM7UUFDRCxNQUFNLElBQUkseUJBQXlCLENBQ2pDLGtCQUFrQixFQUNsQixrRkFBa0YsbUNBQW1DLEdBQUcsQ0FDekgsQ0FBQztJQUNKLENBQUM7SUFDRCxJQUFJLFVBQVUsQ0FBQyxNQUFNLEtBQUssU0FBUyxJQUFJLENBQUMsYUFBYSxDQUFDLFVBQVUsQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDO1FBQ3pFLE1BQU0sSUFBSSx5QkFBeUIsQ0FDakMsa0JBQWtCLEVBQ2xCLHFEQUFxRCxDQUN0RCxDQUFDO0lBQ0osQ0FBQztJQUNELE9BQU87UUFDTCxTQUFTLEVBQUUsU0FBbUI7UUFDOUIsTUFBTSxFQUFFLFVBQVUsQ0FBQyxNQUFpQztLQUNyRCxDQUFDO0FBQ0osQ0FBQyxDQUFDO0FBRUYsTUFBTSwyQkFBMkIsR0FBRyxDQUNsQyxVQUFnRCxFQUNjLEVBQUU7SUFDaEUsTUFBTSxPQUFPLEdBQUcscUJBQXFCLENBQ25DLFVBQVUsRUFDVixDQUFDLGlCQUFpQixFQUFFLG9CQUFvQixFQUFFLFdBQVcsRUFBRSxRQUFRLENBQUMsRUFDaEUsK0JBQStCLENBQ2hDLENBQUM7SUFDRixJQUNFLE9BQU8sT0FBTyxDQUFDLGVBQWUsS0FBSyxRQUFRO1dBQ3hDLENBQUMsbUJBQW1CLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxlQUFlLENBQUMsRUFDckQsQ0FBQztRQUNELE1BQU0sSUFBSSx5QkFBeUIsQ0FDakMsa0JBQWtCLEVBQ2xCLDZEQUE2RCxDQUM5RCxDQUFDO0lBQ0osQ0FBQztJQUNELElBQUksT0FBTyxPQUFPLENBQUMsa0JBQWtCLEtBQUssUUFBUSxFQUFFLENBQUM7UUFDbkQsTUFBTSxJQUFJLHlCQUF5QixDQUNqQyxrQkFBa0IsRUFDbEIsaUVBQWlFLENBQ2xFLENBQUM7SUFDSixDQUFDO0lBQ0QsTUFBTSxXQUFXLEdBQUcscUJBQXFCLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxrQkFBa0IsQ0FBQyxDQUFDO0lBQzNFLE1BQU0sSUFBSSxHQUFHLFdBQVcsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDdEQsSUFBSSxDQUFDLFdBQVcsSUFBSSxJQUFJLEdBQUcsQ0FBQyxJQUFJLElBQUksR0FBRyxNQUFNLEVBQUUsQ0FBQztRQUM5QyxNQUFNLElBQUkseUJBQXlCLENBQ2pDLGtCQUFrQixFQUNsQixpRUFBaUUsQ0FDbEUsQ0FBQztJQUNKLENBQUM7SUFDRCxPQUFPO1FBQ0wsZUFBZSxFQUFFLE9BQU8sQ0FBQyxlQUFlO1FBQ3hDLGtCQUFrQixFQUFFLE9BQU8sQ0FBQyxrQkFBa0I7UUFDOUMsR0FBRyxzQkFBc0IsQ0FBQyxPQUFPLENBQUM7S0FDbkMsQ0FBQztBQUNKLENBQUMsQ0FBQztBQUVGLE1BQU0sa0JBQWtCLEdBQUcsQ0FDekIsUUFBaUIsRUFDakIsT0FBZSxFQUNmLFdBQW1CLEVBQ1YsRUFBRSxDQUFDLFFBQVEsWUFBWSxPQUFPLENBQUMsT0FBTyxDQUFDLGdCQUFnQjtPQUM3RCxDQUFDLFFBQVEsQ0FBQyxJQUFJLEtBQUssT0FBTyxJQUFJLFFBQVEsQ0FBQyxRQUFRLEtBQUssV0FBVyxDQUFDLENBQUM7QUFFdEUsTUFBTSxtQkFBbUIsR0FBRyxDQUFDLFFBQWlCLEVBQVcsRUFBRSxDQUFDLENBQzFELFFBQVEsWUFBWSxPQUFPLENBQUMsT0FBTyxDQUFDLDBCQUEwQixDQUMvRCxDQUFDO0FBRUYsTUFBTSxxQ0FBcUMsR0FBRyxDQUFDLFFBQWlCLEVBQVcsRUFBRSxDQUFDLENBQzVFLGtCQUFrQixDQUFDLFFBQVEsRUFBRSxFQUFFLEVBQUUsa0JBQWtCLENBQUM7T0FDakQsa0JBQWtCLENBQUMsUUFBUSxFQUFFLEdBQUcsRUFBRSxvQ0FBb0MsQ0FBQyxDQUMzRSxDQUFDO0FBRUYsTUFBTSx3QkFBd0IsR0FBRyxDQUFDLFFBQWlCLEVBQVcsRUFBRSxDQUFDLENBQy9ELGtCQUFrQixDQUFDLFFBQVEsRUFBRSxNQUFNLEVBQUUsbUJBQW1CLENBQUM7T0FDdEQsa0JBQWtCLENBQUMsUUFBUSxFQUFFLE1BQU0sRUFBRSxlQUFlLENBQUMsQ0FDekQsQ0FBQztBQUVGLE1BQU0sbUJBQW1CLEdBQUcsQ0FBQyxRQUFpQixFQUFXLEVBQUUsQ0FBQyxDQUMxRCxrQkFBa0IsQ0FBQyxRQUFRLEVBQUUsRUFBRSxFQUFFLGNBQWMsQ0FBQyxDQUNqRCxDQUFDO0FBRUYsTUFBTSxPQUFPLDRCQUE0QjtJQUN0QixLQUFLLENBQWM7SUFDbkIsZUFBZSxDQUFxQjtJQUNwQyxxQkFBcUIsQ0FBOEI7SUFFcEUsWUFBWSxRQUFxQjtRQUMvQixJQUNFLFFBQVEsQ0FBQyxNQUFNLEtBQUssV0FBVztlQUM1QixDQUFDLFFBQVEsQ0FBQyxPQUFPO2VBQ2pCLENBQUMsUUFBUSxDQUFDLGFBQWE7ZUFDdkIsUUFBUSxDQUFDLE9BQU8sQ0FBQyxNQUFNLEtBQUssUUFBUSxDQUFDLGFBQWEsRUFDckQsQ0FBQztZQUNELE1BQU0sSUFBSSx5QkFBeUIsQ0FDakMsdUJBQXVCLEVBQ3ZCLCtEQUErRCxDQUNoRSxDQUFDO1FBQ0osQ0FBQztRQUNELElBQUksQ0FBQyxLQUFLLEdBQUcsUUFBUSxDQUFDO1FBQ3RCLElBQUksQ0FBQyxlQUFlLEdBQUcsUUFBUSxDQUFDLE9BQU8sQ0FBQztRQUN4QyxJQUFJLENBQUMscUJBQXFCLEdBQUcsUUFBUSxDQUFDLGFBQWEsQ0FBQztJQUN0RCxDQUFDO0lBRU0sS0FBSyxDQUFDLGlCQUFpQixDQUM1QixVQUFnRDtRQUVoRCxNQUFNLE9BQU8sR0FBRywyQkFBMkIsQ0FBQyxVQUFVLENBQUMsQ0FBQztRQUN4RCxNQUFNLFNBQVMsR0FBRyxXQUFXLENBQUMsR0FBRyxFQUFFLENBQUM7UUFDcEMsTUFBTSxPQUFPLEdBQUcsSUFBSSxDQUFDLG1CQUFtQixFQUFFLENBQUM7UUFDM0MsSUFBSSxPQUFPLENBQUMsTUFBTSxFQUFFLE9BQU8sRUFBRSxDQUFDO1lBQzVCLE9BQU87Z0JBQ0wsS0FBSyxFQUFFLGFBQWE7Z0JBQ3BCLFVBQVUsRUFBRSxXQUFXLENBQUMsR0FBRyxFQUFFLEdBQUcsU0FBUzthQUMxQyxDQUFDO1FBQ0osQ0FBQztRQUVELElBQUksTUFBcUMsQ0FBQztRQUMxQyxJQUFJLENBQUM7WUFDSCxNQUFNLEdBQUcsTUFBTSxPQUFPLENBQUMsT0FBTyxDQUFDLEtBQUssRUFBRSxDQUFDLE9BQU8sQ0FDNUMsRUFBRSxnQkFBZ0IsRUFBRSxDQUFDLEVBQUUsRUFDdkI7Z0JBQ0UsU0FBUyxFQUFFLE9BQU8sQ0FBQyxTQUFTO2dCQUM1QixNQUFNLEVBQUUsT0FBTyxDQUFDLE1BQU07YUFDdkIsQ0FDRixDQUFDO1FBQ0osQ0FBQztRQUFDLE9BQU8sUUFBUSxFQUFFLENBQUM7WUFDbEIsSUFBSSxDQUFDLElBQUksQ0FBQyxnQkFBZ0IsQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDO2dCQUNwQyxPQUFPLElBQUksQ0FBQyxvQkFBb0IsQ0FBQyxhQUFhLEVBQUUsU0FBUyxDQUFDLENBQUM7WUFDN0QsQ0FBQztZQUNELElBQUksa0JBQWtCLENBQUMsUUFBUSxFQUFFLEVBQUUsRUFBRSxzQkFBc0IsQ0FBQyxFQUFFLENBQUM7Z0JBQzdELE9BQU8sSUFBSSxDQUFDLG9CQUFvQixDQUFDLHNCQUFzQixFQUFFLFNBQVMsQ0FBQyxDQUFDO1lBQ3RFLENBQUM7WUFDRCxJQUFJLGtCQUFrQixDQUFDLFFBQVEsRUFBRSxFQUFFLEVBQUUsbUJBQW1CLENBQUMsRUFBRSxDQUFDO2dCQUMxRCxPQUFPLElBQUksQ0FBQyxvQkFBb0IsQ0FBQyxlQUFlLEVBQUUsU0FBUyxDQUFDLENBQUM7WUFDL0QsQ0FBQztZQUNELE9BQU8sSUFBSSxDQUFDLG9CQUFvQixDQUFDLGFBQWEsRUFBRSxTQUFTLENBQUMsQ0FBQztRQUM3RCxDQUFDO1FBRUQsSUFBSSxDQUFDLElBQUksQ0FBQyxnQkFBZ0IsQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDO1lBQ3BDLE9BQU8sSUFBSSxDQUFDLG9CQUFvQixDQUFDLGFBQWEsRUFBRSxTQUFTLENBQUMsQ0FBQztRQUM3RCxDQUFDO1FBQ0QsTUFBTSxlQUFlLEdBQUcsT0FBTyxNQUFNLENBQUMsR0FBRyxLQUFLLFFBQVEsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDO1FBQ2hGLE1BQU0sVUFBVSxHQUFHLEtBQUssQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7UUFDdkUsTUFBTSxlQUFlLEdBQXNDLEVBQUUsQ0FBQztRQUM5RCxJQUFJLGlCQUFpQixHQUFHLEtBQUssQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQ3RELEtBQUssTUFBTSxTQUFTLElBQUksVUFBVSxFQUFFLENBQUM7WUFDbkMsSUFBSSxDQUFDLFNBQVMsSUFBSSxPQUFPLFNBQVMsS0FBSyxRQUFRLElBQUksS0FBSyxDQUFDLE9BQU8sQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDO2dCQUM1RSxpQkFBaUIsR0FBRyxLQUFLLENBQUM7Z0JBQzFCLFNBQVM7WUFDWCxDQUFDO1lBQ0QsTUFBTSxNQUFNLEdBQUcsU0FBb0MsQ0FBQztZQUNwRCxJQUNFLE9BQU8sTUFBTSxDQUFDLElBQUksS0FBSyxRQUFRO21CQUM1QixPQUFPLE1BQU0sQ0FBQyxRQUFRLEtBQUssUUFBUTttQkFDbkMsT0FBTyxNQUFNLENBQUMsTUFBTSxLQUFLLFFBQVE7bUJBQ2pDLENBQUMsTUFBTSxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQ2xDLENBQUM7Z0JBQ0QsaUJBQWlCLEdBQUcsS0FBSyxDQUFDO2dCQUMxQixTQUFTO1lBQ1gsQ0FBQztZQUNELGVBQWUsQ0FBQyxJQUFJLENBQUM7Z0JBQ25CLElBQUksRUFBRSxNQUFNLENBQUMsSUFBSTtnQkFDakIsTUFBTSxFQUFFLE1BQU0sQ0FBQyxNQUFNO2dCQUNyQixLQUFLLEVBQUUsTUFBTSxDQUFDLFFBQVE7YUFDdkIsQ0FBQyxDQUFDO1FBQ0wsQ0FBQztRQUNELE1BQU0sa0JBQWtCLEdBQUcsaUJBQWlCO2VBQ3ZDLFVBQVUsQ0FBQyxNQUFNLEtBQUssZUFBZSxDQUFDLE1BQU07ZUFDNUMsZUFBZSxLQUFLLE9BQU8sQ0FBQyxlQUFlO2VBQzNDLGVBQWUsQ0FBQyxNQUFNLEtBQUssQ0FBQztlQUM1QixlQUFlLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxLQUFLLE9BQU8sQ0FBQyxrQkFBa0IsQ0FBQztRQUM1RCxJQUFJLENBQUMsa0JBQWtCLEVBQUUsQ0FBQztZQUN4QixPQUFPO2dCQUNMLEtBQUssRUFBRSxXQUFXO2dCQUNsQixlQUFlO2dCQUNmLGVBQWU7Z0JBQ2YsVUFBVSxFQUFFLFdBQVcsQ0FBQyxHQUFHLEVBQUUsR0FBRyxTQUFTO2FBQzFDLENBQUM7UUFDSixDQUFDO1FBQ0QsTUFBTSxZQUFZLEdBQUcsTUFBTSxDQUFDLE9BQU8sS0FBSyxDQUFDO2VBQ3BDLGVBQWUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxLQUFLLEtBQUssU0FBUztlQUN0QyxlQUFlLENBQUMsQ0FBQyxDQUFDLENBQUMsTUFBTSxLQUFLLENBQUMsQ0FBQztRQUNyQyxPQUFPO1lBQ0wsS0FBSyxFQUFFLFlBQVksQ0FBQyxDQUFDLENBQUMsZUFBZSxDQUFDLENBQUMsQ0FBQyxtQkFBbUI7WUFDM0QsZUFBZTtZQUNmLGVBQWU7WUFDZixVQUFVLEVBQUUsV0FBVyxDQUFDLEdBQUcsRUFBRSxHQUFHLFNBQVM7U0FDMUMsQ0FBQztJQUNKLENBQUM7SUFFTSxLQUFLLENBQUMsZ0NBQWdDLENBQzNDLFVBQWdEO1FBRWhELE1BQU0sT0FBTyxHQUFHLDJCQUEyQixDQUFDLFVBQVUsQ0FBQyxDQUFDO1FBQ3hELE1BQU0sUUFBUSxHQUFHLE1BQU0sSUFBSSxDQUFDLGlCQUFpQixDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQ3ZELElBQUksUUFBUSxDQUFDLEtBQUssS0FBSyxlQUFlLElBQUksUUFBUSxDQUFDLEtBQUssS0FBSyxtQkFBbUIsRUFBRSxDQUFDO1lBQ2pGLE9BQU87Z0JBQ0wsTUFBTSxFQUFFLG9CQUFvQjtnQkFDNUIsUUFBUTthQUNULENBQUM7UUFDSixDQUFDO1FBQ0QsSUFBSSxRQUFRLENBQUMsS0FBSyxLQUFLLFdBQVcsRUFBRSxDQUFDO1lBQ25DLE1BQU0sSUFBSSx5QkFBeUIsQ0FDakMsdUJBQXVCLEVBQ3ZCLDJFQUEyRSxDQUM1RSxDQUFDO1FBQ0osQ0FBQztRQUNELElBQUksUUFBUSxDQUFDLEtBQUssS0FBSyxzQkFBc0IsRUFBRSxDQUFDO1lBQzlDLE1BQU0sSUFBSSx5QkFBeUIsQ0FDakMsdUJBQXVCLEVBQ3ZCLHNFQUFzRSxDQUN2RSxDQUFDO1FBQ0osQ0FBQztRQUNELElBQUksUUFBUSxDQUFDLEtBQUssS0FBSyxlQUFlLEVBQUUsQ0FBQztZQUN2QyxNQUFNLElBQUkseUJBQXlCLENBQ2pDLHVCQUF1QixFQUN2QiwrREFBK0QsQ0FDaEUsQ0FBQztRQUNKLENBQUM7UUFFRCxNQUFNLE9BQU8sR0FBRyxJQUFJLENBQUMsbUJBQW1CLEVBQUUsQ0FBQztRQUMzQyxJQUFJLG9CQUFvQixHQUE0RCxXQUFXLENBQUM7UUFDaEcsSUFBSSxDQUFDO1lBQ0gsTUFBTSxRQUFRLEdBQUcsTUFBTSxPQUFPLENBQUMsT0FBTyxDQUFDLEtBQUssRUFBRSxDQUFDLE9BQU8sQ0FDcEQ7Z0JBQ0UsZUFBZSxFQUFFO29CQUNmLEdBQUcsRUFBRSxPQUFPLENBQUMsZUFBZTtvQkFDNUIsT0FBTyxFQUFFLENBQUM7NEJBQ1IsR0FBRyxFQUFFLENBQUM7NEJBQ04sSUFBSSxFQUFFLE9BQU8sQ0FBQyxrQkFBa0I7eUJBQ2pDLENBQUM7aUJBQ0g7YUFDRixFQUNEO2dCQUNFLFNBQVMsRUFBRSxPQUFPLENBQUMsU0FBUztnQkFDNUIsTUFBTSxFQUFFLE9BQU8sQ0FBQyxNQUFNO2FBQ3ZCLENBQ0YsQ0FBQztZQUNGLElBQUksUUFBUSxDQUFDLEVBQUUsS0FBSyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsZ0JBQWdCLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQztnQkFDekQsTUFBTSxJQUFJLHlCQUF5QixDQUNqQyx1QkFBdUIsRUFDdkIsdURBQXVELENBQ3hELENBQUM7WUFDSixDQUFDO1FBQ0gsQ0FBQztRQUFDLE9BQU8sUUFBUSxFQUFFLENBQUM7WUFDbEIsSUFBSSxrQkFBa0IsQ0FBQyxRQUFRLEVBQUUsRUFBRSxFQUFFLG9CQUFvQixDQUFDLEVBQUUsQ0FBQztnQkFDM0Qsb0JBQW9CLEdBQUcsb0JBQW9CLENBQUM7WUFDOUMsQ0FBQztpQkFBTSxDQUFDO2dCQUNOLElBQUksUUFBUSxZQUFZLHlCQUF5QjtvQkFBRSxNQUFNLFFBQVEsQ0FBQztnQkFDbEUsTUFBTSxJQUFJLHlCQUF5QixDQUNqQyx1QkFBdUIsRUFDdkIsMENBQTBDLENBQzNDLENBQUM7WUFDSixDQUFDO1FBQ0gsQ0FBQztRQUVELE1BQU0sbUJBQW1CLEdBQUcsTUFBTSxJQUFJLENBQUMsaUJBQWlCLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDbEUsSUFBSSxtQkFBbUIsQ0FBQyxLQUFLLEtBQUssV0FBVyxFQUFFLENBQUM7WUFDOUMsTUFBTSxJQUFJLHlCQUF5QixDQUNqQyx1QkFBdUIsRUFDdkIsNkVBQTZFLENBQzlFLENBQUM7UUFDSixDQUFDO1FBQ0QsSUFDRSxtQkFBbUIsQ0FBQyxLQUFLLEtBQUssZUFBZTtlQUMxQyxtQkFBbUIsQ0FBQyxLQUFLLEtBQUssbUJBQW1CLEVBQ3BELENBQUM7WUFDRCxNQUFNLElBQUkseUJBQXlCLENBQ2pDLHVCQUF1QixFQUN2QiwrRUFBK0UsQ0FDaEYsQ0FBQztRQUNKLENBQUM7UUFDRCxPQUFPO1lBQ0wsTUFBTSxFQUFFLG9CQUFvQjtZQUM1QixRQUFRLEVBQUUsbUJBQW1CO1NBQzlCLENBQUM7SUFDSixDQUFDO0lBRU0sS0FBSyxDQUFDLHlCQUF5QixDQUNwQyxhQUE4QyxFQUFFO1FBRWhELE1BQU0sT0FBTyxHQUFHLHFCQUFxQixDQUNuQyxVQUFVLEVBQ1YsQ0FBQyxXQUFXLEVBQUUsUUFBUSxDQUFDLEVBQ3ZCLHFDQUFxQyxDQUN0QyxDQUFDO1FBQ0YsTUFBTSxjQUFjLEdBQUcsc0JBQXNCLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDdkQsTUFBTSxTQUFTLEdBQUcsV0FBVyxDQUFDLEdBQUcsRUFBRSxDQUFDO1FBQ3BDLE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQyxtQkFBbUIsRUFBRSxDQUFDO1FBQzNDLE1BQU0sT0FBTyxHQUFHLFVBQVUsQ0FBQyxNQUFNLENBQUMsVUFBVSxFQUFFLENBQUM7UUFDL0MsTUFBTSxVQUFVLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxVQUFVLENBQzNDLG1DQUFtQyxDQUNwQyxDQUFDO1FBQ0YsSUFBSSxPQUFrRCxDQUFDO1FBQ3ZELElBQUksT0FBZ0IsQ0FBQztRQUNyQixJQUFJLGFBQWEsR0FBRyxLQUFLLENBQUM7UUFFMUIsSUFBSSxDQUFDO1lBQ0gsSUFBSSxDQUFDO2dCQUNILE1BQU0sT0FBTyxDQUFDLE9BQU8sQ0FBQyxPQUFPLENBQzNCLEVBQUUsTUFBTSxFQUFFLG1DQUFtQyxFQUFFLEVBQy9DO29CQUNFLFNBQVMsRUFBRSxjQUFjLENBQUMsU0FBUztvQkFDbkMsTUFBTSxFQUFFLGNBQWMsQ0FBQyxNQUFNO2lCQUM5QixDQUNGLENBQUM7WUFDSixDQUFDO1lBQUMsT0FBTyxRQUFRLEVBQUUsQ0FBQztnQkFDbEIsSUFBSSxDQUFDLGtCQUFrQixDQUFDLFFBQVEsRUFBRSxFQUFFLEVBQUUsaUJBQWlCLENBQUM7b0JBQUUsTUFBTSxRQUFRLENBQUM7WUFDM0UsQ0FBQztZQUNELE9BQU8sR0FBRyxPQUFPLENBQUMsYUFBYSxDQUFDLFlBQVksRUFBRSxDQUFDO1lBQy9DLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQztnQkFDdkIsV0FBVyxFQUFFLEVBQUUsS0FBSyxFQUFFLFVBQVUsRUFBRTtnQkFDbEMsWUFBWSxFQUFFLEVBQUUsQ0FBQyxFQUFFLFVBQVUsRUFBRTthQUNoQyxDQUFDLENBQUM7WUFDSCxNQUFNLGNBQWMsR0FBRyxNQUFNLE9BQU8sQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUNsRDtnQkFDRSxNQUFNLEVBQUUsbUNBQW1DO2dCQUMzQyxTQUFTLEVBQUU7b0JBQ1QsRUFBRSxHQUFHLEVBQUUsR0FBRyxPQUFPLElBQUksRUFBRSxPQUFPLEVBQUUsSUFBSSxFQUFFLENBQUMsRUFBRTtvQkFDekMsRUFBRSxHQUFHLEVBQUUsR0FBRyxPQUFPLElBQUksRUFBRSxPQUFPLEVBQUUsSUFBSSxFQUFFLENBQUMsRUFBRTtpQkFDMUM7Z0JBQ0QsT0FBTyxFQUFFLElBQUk7YUFDZCxFQUNEO2dCQUNFLE9BQU87Z0JBQ1AsU0FBUyxFQUFFLGNBQWMsQ0FBQyxTQUFTO2dCQUNuQyxNQUFNLEVBQUUsY0FBYyxDQUFDLE1BQU07YUFDOUIsQ0FDRixDQUFDO1lBQ0YsSUFBSSxjQUFjLENBQUMsRUFBRSxLQUFLLENBQUMsSUFBSSxjQUFjLENBQUMsQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDO2dCQUN0RCxNQUFNLElBQUkseUJBQXlCLENBQ2pDLHVCQUF1QixFQUN2QiwwREFBMEQsQ0FDM0QsQ0FBQztZQUNKLENBQUM7WUFDRCxNQUFNLGFBQWEsR0FBRyxNQUFNLE9BQU8sQ0FBQyxPQUFPLENBQUMsS0FBSyxFQUFFLENBQUMsT0FBTyxDQUN6RDtnQkFDRSxnQkFBZ0IsRUFBRSxDQUFDO2dCQUNuQixZQUFZLEVBQUU7b0JBQ1osQ0FBQyxFQUFFLFVBQVU7b0JBQ2IsUUFBUSxFQUFFLGNBQWMsQ0FBQyxTQUFTO2lCQUNuQzthQUNGLEVBQ0Q7Z0JBQ0UsT0FBTztnQkFDUCxTQUFTLEVBQUUsY0FBYyxDQUFDLFNBQVM7Z0JBQ25DLE1BQU0sRUFBRSxjQUFjLENBQUMsTUFBTTthQUM5QixDQUNGLENBQUM7WUFDRixJQUFJLGFBQWEsQ0FBQyxFQUFFLEtBQUssQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLGdCQUFnQixDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUM7Z0JBQzlELE1BQU0sSUFBSSx5QkFBeUIsQ0FDakMsdUJBQXVCLEVBQ3ZCLHdEQUF3RCxDQUN6RCxDQUFDO1lBQ0osQ0FBQztZQUNELHlFQUF5RTtZQUN6RSx3RUFBd0U7WUFDeEUsbUVBQW1FO1lBQ25FLE1BQU0sT0FBTyxDQUFDLGdCQUFnQixDQUFDLEVBQUUsU0FBUyxFQUFFLGNBQWMsQ0FBQyxTQUFTLEVBQUUsQ0FBQyxDQUFDO1lBQ3hFLE1BQU0sY0FBYyxHQUFHLE1BQU0sVUFBVSxDQUFDLGNBQWMsQ0FDcEQsRUFBRSxPQUFPLEVBQUUsRUFDWDtnQkFDRSxLQUFLLEVBQUUsQ0FBQztnQkFDUixTQUFTLEVBQUUsY0FBYyxDQUFDLFNBQVM7Z0JBQ25DLE1BQU0sRUFBRSxjQUFjLENBQUMsTUFBTTthQUM5QixDQUNGLENBQUM7WUFDRixJQUFJLGNBQWMsS0FBSyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsZ0JBQWdCLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQztnQkFDNUQsYUFBYSxHQUFHLGNBQWMsS0FBSyxDQUFDLENBQUM7Z0JBQ3JDLE1BQU0sSUFBSSx5QkFBeUIsQ0FDakMsdUJBQXVCLEVBQ3ZCLGdEQUFnRCxDQUNqRCxDQUFDO1lBQ0osQ0FBQztZQUNELE9BQU87Z0JBQ0wsS0FBSyxFQUFFLElBQUk7Z0JBQ1gsTUFBTSxFQUFFLE9BQU87Z0JBQ2YsVUFBVSxFQUFFLFdBQVcsQ0FBQyxHQUFHLEVBQUUsR0FBRyxTQUFTO2FBQzFDLENBQUM7UUFDSixDQUFDO1FBQUMsT0FBTyxRQUFRLEVBQUUsQ0FBQztZQUNsQixPQUFPLEdBQUcsUUFBUSxDQUFDO1lBQ25CLElBQUksT0FBTyxFQUFFLGFBQWEsRUFBRSxFQUFFLENBQUM7Z0JBQzdCLElBQUksQ0FBQztvQkFDSCxNQUFNLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxFQUFFLFNBQVMsRUFBRSxjQUFjLENBQUMsU0FBUyxFQUFFLENBQUMsQ0FBQztnQkFDMUUsQ0FBQztnQkFBQyxNQUFNLENBQUM7b0JBQ1AsYUFBYSxHQUFHLElBQUksQ0FBQztnQkFDdkIsQ0FBQztZQUNILENBQUM7WUFDRCxJQUFJLENBQUM7Z0JBQ0gsTUFBTSxVQUFVLENBQUMsVUFBVSxDQUN6QixFQUFFLE9BQU8sRUFBRSxFQUNYLEVBQUUsU0FBUyxFQUFFLGNBQWMsQ0FBQyxTQUFTLEVBQUUsQ0FDeEMsQ0FBQztZQUNKLENBQUM7WUFBQyxNQUFNLENBQUM7Z0JBQ1AsYUFBYSxHQUFHLElBQUksQ0FBQztZQUN2QixDQUFDO1FBQ0gsQ0FBQztnQkFBUyxDQUFDO1lBQ1QsTUFBTSxPQUFPLEVBQUUsVUFBVSxFQUFFLENBQUMsS0FBSyxDQUFDLEdBQUcsRUFBRSxDQUFDLFNBQVMsQ0FBQyxDQUFDO1FBQ3JELENBQUM7UUFFRCxJQUFJLE1BQXdELENBQUM7UUFDN0QsSUFBSSxhQUFhLEVBQUUsQ0FBQztZQUNsQixNQUFNLEdBQUcsZ0JBQWdCLENBQUM7UUFDNUIsQ0FBQzthQUFNLElBQUksY0FBYyxDQUFDLE1BQU0sRUFBRSxPQUFPLEVBQUUsQ0FBQztZQUMxQyxNQUFNLEdBQUcsU0FBUyxDQUFDO1FBQ3JCLENBQUM7YUFBTSxJQUFJLG1CQUFtQixDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUM7WUFDeEMsTUFBTSxHQUFHLFNBQVMsQ0FBQztRQUNyQixDQUFDO2FBQU0sSUFBSSxxQ0FBcUMsQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDO1lBQzFELE1BQU0sR0FBRyxzQkFBc0IsQ0FBQztRQUNsQyxDQUFDO2FBQU0sQ0FBQztZQUNOLE1BQU0sR0FBRyxhQUFhLENBQUM7UUFDekIsQ0FBQztRQUNELE9BQU87WUFDTCxLQUFLLEVBQUUsS0FBSztZQUNaLE1BQU0sRUFBRSxhQUFhO1lBQ3JCLE1BQU07WUFDTixVQUFVLEVBQUUsV0FBVyxDQUFDLEdBQUcsRUFBRSxHQUFHLFNBQVM7U0FDMUMsQ0FBQztJQUNKLENBQUM7SUFFTSxLQUFLLENBQUMsMkJBQTJCLENBQ3RDLFVBQThDO1FBRTlDLE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQyx5QkFBeUIsQ0FBQyxVQUFVLEVBQUUsSUFBSSxDQUFDLENBQUM7UUFDakUsTUFBTSxPQUFPLEdBQUcsSUFBSSxDQUFDLG1CQUFtQixDQUFDLE9BQU8sQ0FBQyxvQkFBb0IsQ0FBQyxDQUFDO1FBQ3ZFLE1BQU0sU0FBUyxHQUFHLE1BQU0sSUFBSSxDQUFDLHdCQUF3QixDQUNuRCxPQUFPLEVBQ1A7WUFDRSxTQUFTLEVBQUU7Z0JBQ1QsSUFBSSxFQUFFLE9BQU8sQ0FBQyxRQUFRO2dCQUN0QixFQUFFLEVBQUUsT0FBTyxDQUFDLG9CQUFvQjthQUNqQztTQUNGLEVBQ0QsT0FBTyxFQUNQLHdDQUF3QyxDQUN6QyxDQUFDO1FBQ0YsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsU0FBUyxDQUFDLEtBQUssQ0FBQyxJQUFJLFNBQVMsQ0FBQyxLQUFLLENBQUMsTUFBTSxHQUFHLENBQUMsRUFBRSxDQUFDO1lBQ2xFLE1BQU0sSUFBSSx5QkFBeUIsQ0FDakMsdUJBQXVCLEVBQ3ZCLDREQUE0RCxDQUM3RCxDQUFDO1FBQ0osQ0FBQztRQUNELE1BQU0sYUFBYSxHQUFHO1lBQ3BCLFVBQVUsRUFBRSxPQUFPLENBQUMsUUFBUTtZQUM1QixHQUFHLEVBQUUsT0FBTyxDQUFDLFFBQVE7WUFDckIsS0FBSyxFQUFFLENBQUMsRUFBRSxJQUFJLEVBQUUsV0FBVyxFQUFFLEVBQUUsRUFBRSxPQUFPLENBQUMsb0JBQW9CLEVBQUUsQ0FBQztTQUNqRSxDQUFDO1FBQ0YsSUFBSSxTQUFTLENBQUMsS0FBSyxDQUFDLE1BQU0sS0FBSyxDQUFDLEVBQUUsQ0FBQztZQUNqQyxNQUFNLElBQUksQ0FBQyx3QkFBd0IsQ0FDakMsT0FBTyxFQUNQLGFBQWEsRUFDYixPQUFPLEVBQ1AsNENBQTRDLENBQzdDLENBQUM7WUFDRixPQUFPLEVBQUUsTUFBTSxFQUFFLFNBQVMsRUFBRSxDQUFDO1FBQy9CLENBQUM7UUFFRCxJQUFJLENBQUM7WUFDSCxNQUFNLElBQUksQ0FBQyw0QkFBNEIsQ0FDckMsT0FBTyxFQUNQO2dCQUNFLFVBQVUsRUFBRSxPQUFPLENBQUMsUUFBUTtnQkFDNUIsR0FBRyxFQUFFLE9BQU8sQ0FBQyxRQUFRO2dCQUNyQixLQUFLLEVBQUUsQ0FBQyxFQUFFLElBQUksRUFBRSxXQUFXLEVBQUUsRUFBRSxFQUFFLE9BQU8sQ0FBQyxvQkFBb0IsRUFBRSxDQUFDO2FBQ2pFLEVBQ0QsT0FBTyxDQUNSLENBQUM7WUFDRixPQUFPLEVBQUUsTUFBTSxFQUFFLFNBQVMsRUFBRSxDQUFDO1FBQy9CLENBQUM7UUFBQyxPQUFPLFFBQVEsRUFBRSxDQUFDO1lBQ2xCLElBQUksQ0FBQyx3QkFBd0IsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDO2dCQUN4QyxNQUFNLElBQUkseUJBQXlCLENBQ2pDLHVCQUF1QixFQUN2Qiw0Q0FBNEMsQ0FDN0MsQ0FBQztZQUNKLENBQUM7UUFDSCxDQUFDO1FBRUQsTUFBTSxJQUFJLENBQUMsd0JBQXdCLENBQ2pDLE9BQU8sRUFDUCxhQUFhLEVBQ2IsT0FBTyxFQUNQLDRDQUE0QyxDQUM3QyxDQUFDO1FBQ0YsT0FBTyxFQUFFLE1BQU0sRUFBRSxTQUFTLEVBQUUsQ0FBQztJQUMvQixDQUFDO0lBRU0sS0FBSyxDQUFDLGtCQUFrQixDQUM3QixVQUFxRDtRQUVyRCxNQUFNLE9BQU8sR0FBRyxJQUFJLENBQUMseUJBQXlCLENBQUMsVUFBVSxFQUFFLEtBQUssQ0FBQyxDQUFDO1FBQ2xFLE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQyxtQkFBbUIsQ0FBQyxPQUFPLENBQUMsb0JBQW9CLENBQUMsQ0FBQztRQUN2RSxNQUFNLFNBQVMsR0FBRyxNQUFNLElBQUksQ0FBQyx3QkFBd0IsQ0FDbkQsT0FBTyxFQUNQO1lBQ0UsU0FBUyxFQUFFO2dCQUNULElBQUksRUFBRSxPQUFPLENBQUMsUUFBUTtnQkFDdEIsRUFBRSxFQUFFLE9BQU8sQ0FBQyxvQkFBb0I7YUFDakM7U0FDRixFQUNELE9BQU8sRUFDUCx3Q0FBd0MsQ0FDekMsQ0FBQztRQUNGLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLFNBQVMsQ0FBQyxLQUFLLENBQUMsSUFBSSxTQUFTLENBQUMsS0FBSyxDQUFDLE1BQU0sR0FBRyxDQUFDLEVBQUUsQ0FBQztZQUNsRSxNQUFNLElBQUkseUJBQXlCLENBQ2pDLHVCQUF1QixFQUN2Qiw0REFBNEQsQ0FDN0QsQ0FBQztRQUNKLENBQUM7UUFDRCxJQUFJLFNBQVMsQ0FBQyxLQUFLLENBQUMsTUFBTSxLQUFLLENBQUM7WUFBRSxPQUFPLEVBQUUsT0FBTyxFQUFFLEtBQUssRUFBRSxDQUFDO1FBQzVELElBQUksQ0FBQztZQUNILE1BQU0sSUFBSSxDQUFDLDRCQUE0QixDQUNyQyxPQUFPLEVBQ1AsRUFBRSxRQUFRLEVBQUUsT0FBTyxDQUFDLFFBQVEsRUFBRSxFQUM5QixPQUFPLENBQ1IsQ0FBQztRQUNKLENBQUM7UUFBQyxPQUFPLFFBQVEsRUFBRSxDQUFDO1lBQ2xCLElBQUksbUJBQW1CLENBQUMsUUFBUSxDQUFDO2dCQUFFLE9BQU8sRUFBRSxPQUFPLEVBQUUsS0FBSyxFQUFFLENBQUM7WUFDN0QsTUFBTSxJQUFJLHlCQUF5QixDQUNqQyx1QkFBdUIsRUFDdkIscUNBQXFDLENBQ3RDLENBQUM7UUFDSixDQUFDO1FBQ0QsT0FBTyxFQUFFLE9BQU8sRUFBRSxJQUFJLEVBQUUsQ0FBQztJQUMzQixDQUFDO0lBRU0sS0FBSyxDQUFDLFlBQVksQ0FDdkIsVUFBOEM7UUFFOUMsTUFBTSxPQUFPLEdBQUcscUJBQXFCLENBQ25DLFVBQVUsRUFDVixDQUFDLHNCQUFzQixFQUFFLDBCQUEwQixFQUFFLFdBQVcsRUFBRSxRQUFRLENBQUMsRUFDM0UsNkJBQTZCLENBQzlCLENBQUM7UUFDRixJQUNFLE9BQU8sT0FBTyxDQUFDLG9CQUFvQixLQUFLLFFBQVE7ZUFDN0MsQ0FBQyxpQkFBaUIsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLG9CQUFvQixDQUFDLEVBQ3hELENBQUM7WUFDRCxNQUFNLElBQUkseUJBQXlCLENBQ2pDLGtCQUFrQixFQUNsQiwrREFBK0QsQ0FDaEUsQ0FBQztRQUNKLENBQUM7UUFDRCxJQUNFLE9BQU8sQ0FBQyx3QkFBd0IsS0FBSyxPQUFPLENBQUMsb0JBQW9CO2VBQzlELENBQUMsT0FBTyxFQUFFLFFBQVEsRUFBRSxPQUFPLENBQUMsQ0FBQyxRQUFRLENBQUMsT0FBTyxDQUFDLG9CQUFvQixDQUFDLEVBQ3RFLENBQUM7WUFDRCxNQUFNLElBQUkseUJBQXlCLENBQ2pDLGtCQUFrQixFQUNsQiw0RUFBNEUsQ0FDN0UsQ0FBQztRQUNKLENBQUM7UUFDRCxNQUFNLE9BQU8sR0FBRyxJQUFJLENBQUMsbUJBQW1CLENBQUMsT0FBTyxDQUFDLG9CQUFvQixDQUFDLENBQUM7UUFDdkUsTUFBTSxJQUFJLENBQUMsd0JBQXdCLENBQ2pDLE9BQU8sRUFDUCxFQUFFLFlBQVksRUFBRSxDQUFDLEVBQUUsRUFDbkIsc0JBQXNCLENBQUMsT0FBTyxDQUFDLEVBQy9CLGdDQUFnQyxDQUNqQyxDQUFDO1FBQ0YsT0FBTyxFQUFFLE9BQU8sRUFBRSxJQUFJLEVBQUUsQ0FBQztJQUMzQixDQUFDO0lBRU8sbUJBQW1CLENBQUMsdUJBQWdDO1FBSTFELElBQ0UsSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLEtBQUssV0FBVztlQUM5QixDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTztlQUNuQixDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsYUFBYTtlQUN6QixJQUFJLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxNQUFNLEtBQUssSUFBSSxDQUFDLEtBQUssQ0FBQyxhQUFhO2VBQ3RELElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxLQUFLLElBQUksQ0FBQyxlQUFlO2VBQzNDLElBQUksQ0FBQyxLQUFLLENBQUMsYUFBYSxLQUFLLElBQUksQ0FBQyxxQkFBcUIsRUFDMUQsQ0FBQztZQUNELE1BQU0sSUFBSSx5QkFBeUIsQ0FDakMsdUJBQXVCLEVBQ3ZCLCtEQUErRCxDQUNoRSxDQUFDO1FBQ0osQ0FBQztRQUNELElBQ0UsdUJBQXVCLEtBQUssU0FBUztlQUNsQyxDQUNELElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLFlBQVksS0FBSyx1QkFBdUI7bUJBQ3hELElBQUksQ0FBQyxLQUFLLENBQUMsZ0JBQWdCLENBQUMsV0FBVyxLQUFLLHVCQUF1QixDQUN2RSxFQUNELENBQUM7WUFDRCxNQUFNLElBQUkseUJBQXlCLENBQ2pDLHVCQUF1QixFQUN2QixtRUFBbUUsQ0FDcEUsQ0FBQztRQUNKLENBQUM7UUFDRCxPQUFPO1lBQ0wsT0FBTyxFQUFFLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTztZQUMzQixhQUFhLEVBQUUsSUFBSSxDQUFDLEtBQUssQ0FBQyxhQUFhO1NBQ3hDLENBQUM7SUFDSixDQUFDO0lBRU8sZ0JBQWdCLENBQUMsVUFHeEI7UUFDQyxPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsTUFBTSxLQUFLLFdBQVc7ZUFDbkMsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLEtBQUssVUFBVSxDQUFDLE9BQU87ZUFDekMsSUFBSSxDQUFDLEtBQUssQ0FBQyxhQUFhLEtBQUssVUFBVSxDQUFDLGFBQWEsQ0FBQztJQUM3RCxDQUFDO0lBRU8sb0JBQW9CLENBQzFCLFFBQXdDLEVBQ3hDLFlBQW9CO1FBRXBCLE9BQU87WUFDTCxLQUFLLEVBQUUsUUFBUTtZQUNmLFVBQVUsRUFBRSxXQUFXLENBQUMsR0FBRyxFQUFFLEdBQUcsWUFBWTtTQUM3QyxDQUFDO0lBQ0osQ0FBQztJQUVPLHlCQUF5QixDQUMvQixVQUU2QyxFQUM3QyxjQUE0QjtRQVE1QixNQUFNLFdBQVcsR0FBRyxjQUFjO1lBQ2hDLENBQUMsQ0FBQyxDQUFDLHNCQUFzQixFQUFFLFVBQVUsRUFBRSxVQUFVLEVBQUUsV0FBVyxFQUFFLFFBQVEsQ0FBQztZQUN6RSxDQUFDLENBQUMsQ0FBQyxzQkFBc0IsRUFBRSxVQUFVLEVBQUUsV0FBVyxFQUFFLFFBQVEsQ0FBQyxDQUFDO1FBQ2hFLE1BQU0sT0FBTyxHQUFHLHFCQUFxQixDQUNuQyxVQUFVLEVBQ1YsV0FBVyxFQUNYLDZCQUE2QixDQUM5QixDQUFDO1FBQ0YsSUFDRSxPQUFPLE9BQU8sQ0FBQyxvQkFBb0IsS0FBSyxRQUFRO2VBQzdDLENBQUMsaUJBQWlCLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxvQkFBb0IsQ0FBQyxFQUN4RCxDQUFDO1lBQ0QsTUFBTSxJQUFJLHlCQUF5QixDQUNqQyxrQkFBa0IsRUFDbEIsK0RBQStELENBQ2hFLENBQUM7UUFDSixDQUFDO1FBQ0QsSUFDRSxPQUFPLE9BQU8sQ0FBQyxRQUFRLEtBQUssUUFBUTtlQUNqQyxDQUFDLHFCQUFxQixDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLEVBQ2hELENBQUM7WUFDRCxNQUFNLElBQUkseUJBQXlCLENBQ2pDLGtCQUFrQixFQUNsQiw4RUFBOEUsQ0FDL0UsQ0FBQztRQUNKLENBQUM7UUFDRCxJQUNFLGNBQWM7ZUFDWCxDQUNELE9BQU8sT0FBTyxDQUFDLFFBQVEsS0FBSyxRQUFRO21CQUNqQyxPQUFPLENBQUMsUUFBUSxDQUFDLE1BQU0sR0FBRyxFQUFFO21CQUM1QixPQUFPLENBQUMsUUFBUSxDQUFDLE1BQU0sR0FBRyxJQUFJO21CQUM5QixjQUFjLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsQ0FDekMsRUFDRCxDQUFDO1lBQ0QsTUFBTSxJQUFJLHlCQUF5QixDQUNqQyxrQkFBa0IsRUFDbEIsNEZBQTRGLENBQzdGLENBQUM7UUFDSixDQUFDO1FBQ0QsT0FBTztZQUNMLG9CQUFvQixFQUFFLE9BQU8sQ0FBQyxvQkFBb0I7WUFDbEQsUUFBUSxFQUFFLE9BQU8sQ0FBQyxRQUFRO1lBQzFCLFFBQVEsRUFBRSxDQUFDLGNBQWMsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUV2RDtZQUNELEdBQUcsc0JBQXNCLENBQUMsT0FBTyxDQUFDO1NBQ25DLENBQUM7SUFDSixDQUFDO0lBRU8sS0FBSyxDQUFDLHdCQUF3QixDQUNwQyxVQUdDLEVBQ0QsVUFBeUMsRUFDekMsVUFBdUQsRUFDdkQsaUJBQXlCO1FBRXpCLElBQUksQ0FBQztZQUNILE9BQU8sTUFBTSxJQUFJLENBQUMsNEJBQTRCLENBQzVDLFVBQVUsRUFDVixVQUFVLEVBQ1YsVUFBVSxDQUNYLENBQUM7UUFDSixDQUFDO1FBQUMsTUFBTSxDQUFDO1lBQ1AsTUFBTSxJQUFJLHlCQUF5QixDQUNqQyx1QkFBdUIsRUFDdkIsaUJBQWlCLENBQ2xCLENBQUM7UUFDSixDQUFDO0lBQ0gsQ0FBQztJQUVPLEtBQUssQ0FBQyw0QkFBNEIsQ0FDeEMsVUFHQyxFQUNELFVBQXlDLEVBQ3pDLFVBQXVEO1FBRXZELE1BQU0sUUFBUSxHQUFHLE1BQU0sVUFBVSxDQUFDLE9BQU8sQ0FBQyxPQUFPLENBQUMsVUFBVSxFQUFFO1lBQzVELFNBQVMsRUFBRSxVQUFVLENBQUMsU0FBUztZQUMvQixNQUFNLEVBQUUsVUFBVSxDQUFDLE1BQU07U0FDMUIsQ0FBQyxDQUFDO1FBQ0gsSUFBSSxRQUFRLENBQUMsRUFBRSxLQUFLLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxnQkFBZ0IsQ0FBQyxVQUFVLENBQUMsRUFBRSxDQUFDO1lBQzVELE1BQU0sSUFBSSxLQUFLLENBQUMsdURBQXVELENBQUMsQ0FBQztRQUMzRSxDQUFDO1FBQ0QsT0FBTyxRQUFRLENBQUM7SUFDbEIsQ0FBQztDQUNGIn0=

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

@@ -0,0 +1,42 @@
+import * as plugins from './plugins.js';
+import type { SmartdataDb } from './classes.db.js';
+import { SmartdataSession } from './classes.session.js';
+import { type ISmartdataCollectionTopologyIndex, type TSmartdataCollectionTopologyReasonCode } from './classes.collectiontopology.js';
+export interface ISmartdataNamespaceInspectionOptions {
+    /** Default 256, maximum 1024. Overflow fails the entire observation. */
+    maxCollections?: number;
+    /** Default bounded. Exact counts scan the collection within the shared deadline. */
+    documentCountMode?: 'bounded' | 'exact';
+    /** Default 1, maximum 10000. Read one additional document to detect overflow. */
+    documentCountUpTo?: number;
+    /** Cumulative deadline. Default 5000ms, maximum 120000ms. */
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    /** Owned session for sequential observation; active transactions are unsupported. */
+    session?: SmartdataSession;
+}
+export type TSmartdataObservedDocumentCount = {
+    readonly kind: 'exact';
+    readonly value: number;
+} | {
+    readonly kind: 'at_least';
+    readonly value: number;
+};
+export interface ISmartdataObservedCollection {
+    readonly collectionName: string;
+    readonly namespaceType: 'collection' | 'view' | 'other';
+    readonly reasonCodes: readonly TSmartdataCollectionTopologyReasonCode[];
+    readonly actualIndexes: readonly ISmartdataCollectionTopologyIndex[];
+    readonly documentCount: TSmartdataObservedDocumentCount | null;
+}
+export interface ISmartdataNamespaceInspection {
+    /** Explicitly observational: catalog and data reads are not an atomic snapshot. */
+    readonly consistency: 'observational';
+    readonly collections: readonly ISmartdataObservedCollection[];
+}
+/** @internal Bounded catalog reading shared with collection preparation. */
+export declare const readBoundedInspectionCursor: <T>(cursorArg: plugins.mongodb.AbstractCursor<T>, maximumArg: number, signalArg: AbortSignal, closeOptionsArg?: () => {
+    timeoutMS: number;
+}) => Promise<T[]>;
+/** @internal Entry point exposed through SmartdataDb.inspectNamespace(). */
+export declare const inspectSmartdataNamespace: (dbArg: SmartdataDb, opts?: ISmartdataNamespaceInspectionOptions) => Promise<ISmartdataNamespaceInspection>;