@lossless.org/client 0.1.0

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

@@ -0,0 +1,98 @@
+import * as plugins from './plugins.js';
+import { SmartdataCollection } from './classes.collection.js';
+import { EasyStore } from './classes.easystore.js';
+import { SmartdataMongoAdministration } from './classes.mongoadministration.js';
+import { SmartdataSession } from './classes.session.js';
+import { collectionTopologyDbInspectionSymbol } from './classes.collectiontopology.js';
+import { type ISmartdataNamespaceInspectionOptions, type ISmartdataNamespaceInspection } from './classes.namespaceinspection.js';
+export { SmartdataSession } from './classes.session.js';
+export type { TSmartdataOrdinarySession } from './classes.session.js';
+/**
+ * interface - indicates the connection status of the db
+ */
+export type TConnectionStatus = 'initial' | 'disconnected' | 'connected' | 'failed';
+export interface ISmartdataReadinessOptions {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface ISmartdataInitOptions {
+    /** Bounds connection setup; cleanup is always joined before the call settles. */
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface ISmartdataCloseOptions {
+    /** Total deadline for removal, including preceding session cleanup (1..120000 ms). */
+    timeoutMs?: number;
+    dropDatabase?: {
+        expectedDatabaseName: string;
+    };
+}
+export type TSmartdataReadinessFailureReason = 'not_initialized' | 'connecting' | 'connection_failed' | 'closing' | 'closed' | 'close_failed' | 'aborted' | 'timeout' | 'unavailable';
+export type TSmartdataReadinessResult = {
+    ready: true;
+    status: 'ready';
+    durationMs: number;
+} | {
+    ready: false;
+    status: 'unavailable';
+    reason: TSmartdataReadinessFailureReason;
+    durationMs: number;
+};
+export declare class SmartdataDb {
+    smartdataOptions: plugins.tsclass.database.IMongoDescriptor;
+    mongoDbClient: plugins.mongodb.MongoClient;
+    mongoDb: plugins.mongodb.Db;
+    status: TConnectionStatus;
+    statusConnectedDeferred: plugins.smartpromise.Deferred<void>;
+    smartdataCollectionMap: plugins.lik.ObjectMap<SmartdataCollection<any>>;
+    private lifecycleState;
+    private lifecycleEpoch;
+    private activeLifecycleOperation;
+    private pendingClient?;
+    constructor(smartdataOptions: plugins.tsclass.database.IMongoDescriptor);
+    createEasyStore<T = unknown>(nameIdArg: string): Promise<EasyStore<T>>;
+    /**
+     * connects to the database that was specified during instance creation
+     */
+    init(optionsArg?: ISmartdataInitOptions): Promise<void>;
+    /**
+     * closes the connection to the databse
+     */
+    close(optionsArg?: ISmartdataCloseOptions): Promise<void>;
+    /**
+     * Performs a bounded, read-only round trip to verify database readiness.
+     */
+    checkReadiness(optionsArg?: ISmartdataReadinessOptions): Promise<TSmartdataReadinessResult>;
+    /**
+     * Starts a raw MongoDB session. Use createSession() when every transaction
+     * operation goes through SmartData and stable persistence errors are needed.
+     */
+    startSession(): plugins.mongodb.ClientSession;
+    /**
+     * Creates a SmartData-owned session for model transactions.
+     */
+    createSession(): SmartdataSession;
+    /**
+     * Creates a narrowly scoped MongoDB administration facade bound to this
+     * SmartData lifecycle. Applications never need direct driver access.
+     */
+    createMongoAdministration(): SmartdataMongoAdministration;
+    /** Observe all namespaces, indexes and bounded counts without initializing models. */
+    inspectNamespace(optionsArg?: ISmartdataNamespaceInspectionOptions): Promise<ISmartdataNamespaceInspection>;
+    /** @internal Runs inspection or explicit model preparation against one connection generation. */
+    [collectionTopologyDbInspectionSymbol]<TResult>(operationArg: (mongoDbArg: plugins.mongodb.Db, assertCurrentArg: () => void) => Promise<TResult>): Promise<TResult>;
+    addCollection(SmartdataCollectionArg: SmartdataCollection<any>): void;
+    /**
+     * Gets a collection's name and returns a SmartdataCollection instance
+     * @param nameArg
+     * @returns DbTable
+     */
+    getSmartdataCollectionByName<T>(nameArg: string): Promise<SmartdataCollection<T>>;
+    private beginLifecycleOperation;
+    private assertLifecycleOperationCanBegin;
+    private resolveDatabaseToDrop;
+    private endLifecycleOperation;
+    private transitionLifecycle;
+    private getReadinessLifecycleReason;
+    private createReadinessFailure;
+}

package/dist_ts/nosqldb/classes.db.js

@@ -0,0 +1,434 @@
+import * as plugins from './plugins.js';
+import { SmartdataCollection } from './classes.collection.js';
+import { EasyStore } from './classes.easystore.js';
+import { SmartdataPersistenceError } from './classes.persistence.js';
+import { SmartdataMongoAdministration } from './classes.mongoadministration.js';
+import { createSmartdataSession, invalidateSmartdataSessions, SmartdataSession, unwrapSmartdataSessionInvalidationErrors, } from './classes.session.js';
+import { collectionTopologyDbInspectionSymbol } from './classes.collectiontopology.js';
+import { inspectSmartdataNamespace, } from './classes.namespaceinspection.js';
+export { SmartdataSession } from './classes.session.js';
+import { logger } from './logging.js';
+import { assertDataOptions, SmartdataOperationBudget } from './classes.operationbudget.js';
+const readinessDefaultTimeoutMs = 2_000;
+const readinessMaximumTimeoutMs = 30_000;
+const assertExactDataObject = (valueArg, expectedKeysArg, descriptionArg, allowEmptyArg = false) => {
+    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 ((!allowEmptyArg && keys.length !== expectedKeysArg.length) ||
+        (allowEmptyArg && keys.length !== 0 && keys.length !== expectedKeysArg.length) ||
+        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;
+};
+export class SmartdataDb {
+    smartdataOptions;
+    mongoDbClient;
+    mongoDb;
+    status;
+    statusConnectedDeferred = plugins.smartpromise.defer();
+    smartdataCollectionMap = new plugins.lik.ObjectMap();
+    lifecycleState = 'initial';
+    lifecycleEpoch = 0;
+    activeLifecycleOperation = null;
+    pendingClient;
+    constructor(smartdataOptions) {
+        this.smartdataOptions = smartdataOptions;
+        this.status = 'initial';
+        void this.statusConnectedDeferred.promise.catch(() => { });
+    }
+    // easystore
+    async createEasyStore(nameIdArg) {
+        const easyStore = new EasyStore(nameIdArg, this);
+        return easyStore;
+    }
+    // basic connection stuff ----------------------------------------------
+    /**
+     * connects to the database that was specified during instance creation
+     */
+    async init(optionsArg = {}) {
+        this.assertLifecycleOperationCanBegin('init');
+        const options = assertDataOptions(optionsArg, ['timeoutMs', 'signal']);
+        const budget = Object.keys(options).length
+            ? new SmartdataOperationBudget(options.timeoutMs ?? 30_000, options.signal) : undefined;
+        try {
+            budget?.check();
+        }
+        catch (errorArg) {
+            budget?.close();
+            throw errorArg;
+        }
+        this.beginLifecycleOperation('init');
+        this.transitionLifecycle('connecting');
+        let candidateClient;
+        try {
+            try {
+                // Safely encode credentials to handle special characters
+                const encodedUser = this.smartdataOptions.mongoDbUser
+                    ? encodeURIComponent(this.smartdataOptions.mongoDbUser)
+                    : '';
+                const encodedPass = this.smartdataOptions.mongoDbPass
+                    ? encodeURIComponent(this.smartdataOptions.mongoDbPass)
+                    : '';
+                const finalConnectionUrl = this.smartdataOptions.mongoDbUrl
+                    .replace('<USERNAME>', encodedUser)
+                    .replace('<username>', encodedUser)
+                    .replace('<USER>', encodedUser)
+                    .replace('<user>', encodedUser)
+                    .replace('<PASSWORD>', encodedPass)
+                    .replace('<password>', encodedPass)
+                    .replace('<DBNAME>', this.smartdataOptions.mongoDbName || '')
+                    .replace('<dbname>', this.smartdataOptions.mongoDbName || '');
+                const descriptor = this.smartdataOptions;
+                const clientOptions = {
+                    maxPoolSize: descriptor.maxPoolSize ?? 100,
+                    maxIdleTimeMS: descriptor.maxIdleTimeMS ?? 300000,
+                    serverSelectionTimeoutMS: budget?.remainingMs() ?? descriptor.serverSelectionTimeoutMS ?? 30000,
+                    ...(budget ? { connectTimeoutMS: budget.remainingMs() } : {}),
+                    socketTimeoutMS: descriptor.socketTimeoutMS ?? 30000,
+                    retryWrites: true,
+                };
+                candidateClient = new plugins.mongodb.MongoClient(finalConnectionUrl, clientOptions);
+                this.pendingClient = candidateClient;
+                const connectingClient = candidateClient;
+                let cancellationCleanup;
+                const onAbort = () => {
+                    cancellationCleanup ??= connectingClient.close();
+                    // The connection and this cleanup are both joined below.
+                    void cancellationCleanup.catch(() => { });
+                };
+                budget?.signal.addEventListener('abort', onAbort, { once: true });
+                try {
+                    budget?.check();
+                    await connectingClient.connect();
+                    budget?.check();
+                }
+                finally {
+                    budget?.signal.removeEventListener('abort', onAbort);
+                    if (cancellationCleanup)
+                        await cancellationCleanup;
+                }
+                const candidateDb = candidateClient.db(this.smartdataOptions.mongoDbName);
+                for (const collection of this.smartdataCollectionMap.getArray()) {
+                    collection.resetForDatabaseReconnect();
+                }
+                budget?.check();
+                this.mongoDbClient = candidateClient;
+                this.mongoDb = candidateDb;
+                candidateClient = undefined;
+                this.pendingClient = undefined;
+                this.status = 'connected';
+                this.transitionLifecycle('connected');
+                this.statusConnectedDeferred.resolve();
+                logger.log('info', `Connected to database ${this.smartdataOptions.mongoDbName}`);
+            }
+            catch (error) {
+                let cleanupError;
+                if (candidateClient) {
+                    try {
+                        // A cancelled connect may establish resources after its first close.
+                        await candidateClient.close();
+                        this.pendingClient = undefined;
+                    }
+                    catch (errorArg) {
+                        cleanupError = errorArg;
+                    }
+                }
+                this.status = 'disconnected';
+                this.transitionLifecycle(this.pendingClient ? 'close_failed' : 'connection_failed');
+                logger.log('error', 'Failed to connect to the SmartData database.');
+                if (budget) {
+                    throw new SmartdataPersistenceError('unsupported_operation', this.pendingClient
+                        ? 'SmartData connection setup and cleanup failed; close must be retried.'
+                        : 'SmartData connection setup failed or was cancelled.');
+                }
+                if (cleanupError)
+                    throw new AggregateError([error, cleanupError], 'SmartData connection setup and cleanup failed; close must be retried.');
+                throw error;
+            }
+        }
+        finally {
+            this.endLifecycleOperation('init');
+            budget?.close();
+        }
+    }
+    /**
+     * closes the connection to the databse
+     */
+    async close(optionsArg = {}) {
+        this.assertLifecycleOperationCanBegin('close');
+        const databaseToDrop = this.resolveDatabaseToDrop(optionsArg);
+        const timeoutMs = Object.hasOwn(optionsArg, 'timeoutMs') ? optionsArg.timeoutMs : undefined;
+        const budget = timeoutMs === undefined ? undefined : new SmartdataOperationBudget(timeoutMs);
+        this.beginLifecycleOperation('close');
+        this.transitionLifecycle('closing');
+        this.status = 'disconnected';
+        const mongoDbClient = this.pendingClient ?? this.mongoDbClient;
+        try {
+            const closeErrors = [];
+            try {
+                await invalidateSmartdataSessions(this);
+            }
+            catch (errorArg) {
+                closeErrors.push(...(unwrapSmartdataSessionInvalidationErrors(errorArg) ?? [errorArg]));
+            }
+            if (databaseToDrop) {
+                try {
+                    const databaseDropped = await databaseToDrop.dropDatabase(budget?.operationOptions());
+                    if (!databaseDropped) {
+                        throw new SmartdataPersistenceError('unsupported_operation', 'MongoDB did not acknowledge the requested database removal.');
+                    }
+                }
+                catch (errorArg) {
+                    closeErrors.push(errorArg);
+                }
+            }
+            try {
+                await mongoDbClient?.close();
+                this.pendingClient = undefined;
+            }
+            catch (errorArg) {
+                closeErrors.push(errorArg);
+            }
+            if (closeErrors.length > 0) {
+                this.transitionLifecycle('close_failed');
+                if (budget)
+                    throw new SmartdataPersistenceError('unsupported_operation', 'SmartData database cleanup failed; close must be retried.');
+                if (closeErrors.length === 1) {
+                    throw closeErrors[0];
+                }
+                throw new AggregateError(closeErrors, 'Multiple SmartData database cleanup operations failed.');
+            }
+            this.transitionLifecycle('closed');
+            logger.log('info', `disconnected from database ${this.smartdataOptions.mongoDbName}`);
+        }
+        finally {
+            this.endLifecycleOperation('close');
+            budget?.close();
+        }
+    }
+    /**
+     * Performs a bounded, read-only round trip to verify database readiness.
+     */
+    async checkReadiness(optionsArg = {}) {
+        const startedAt = performance.now();
+        const timeoutMs = optionsArg.timeoutMs ?? readinessDefaultTimeoutMs;
+        if (!Number.isSafeInteger(timeoutMs) ||
+            timeoutMs <= 0 ||
+            timeoutMs > readinessMaximumTimeoutMs) {
+            throw new SmartdataPersistenceError('invalid_argument', `Readiness timeoutMs must be a positive safe integer no greater than ${readinessMaximumTimeoutMs}.`);
+        }
+        const lifecycleReason = this.getReadinessLifecycleReason();
+        if (lifecycleReason) {
+            return this.createReadinessFailure(lifecycleReason, startedAt);
+        }
+        const signal = optionsArg.signal;
+        if (signal?.aborted) {
+            return this.createReadinessFailure('aborted', startedAt);
+        }
+        const lifecycleEpoch = this.lifecycleEpoch;
+        const mongoDb = this.mongoDb;
+        const mongoDbClient = this.mongoDbClient;
+        let response;
+        try {
+            response = await mongoDb.command({ ping: 1 }, {
+                timeoutMS: timeoutMs,
+                signal,
+            });
+        }
+        catch (error) {
+            if (signal?.aborted) {
+                return this.createReadinessFailure('aborted', startedAt);
+            }
+            if (this.lifecycleEpoch !== lifecycleEpoch ||
+                this.mongoDb !== mongoDb ||
+                this.mongoDbClient !== mongoDbClient) {
+                return this.createReadinessFailure(this.getReadinessLifecycleReason() ?? 'unavailable', startedAt);
+            }
+            if (error instanceof plugins.mongodb.MongoOperationTimeoutError) {
+                return this.createReadinessFailure('timeout', startedAt);
+            }
+            return this.createReadinessFailure('unavailable', startedAt);
+        }
+        if (this.lifecycleEpoch !== lifecycleEpoch ||
+            this.mongoDb !== mongoDb ||
+            this.mongoDbClient !== mongoDbClient) {
+            return this.createReadinessFailure(this.getReadinessLifecycleReason() ?? 'unavailable', startedAt);
+        }
+        if (response.ok !== 1) {
+            return this.createReadinessFailure('unavailable', startedAt);
+        }
+        return {
+            ready: true,
+            status: 'ready',
+            durationMs: performance.now() - startedAt,
+        };
+    }
+    /**
+     * Starts a raw MongoDB session. Use createSession() when every transaction
+     * operation goes through SmartData and stable persistence errors are needed.
+     */
+    startSession() {
+        return this.mongoDbClient.startSession();
+    }
+    /**
+     * Creates a SmartData-owned session for model transactions.
+     */
+    createSession() {
+        return createSmartdataSession(this);
+    }
+    /**
+     * Creates a narrowly scoped MongoDB administration facade bound to this
+     * SmartData lifecycle. Applications never need direct driver access.
+     */
+    createMongoAdministration() {
+        return new SmartdataMongoAdministration(this);
+    }
+    /** Observe all namespaces, indexes and bounded counts without initializing models. */
+    async inspectNamespace(optionsArg) {
+        return inspectSmartdataNamespace(this, optionsArg);
+    }
+    /** @internal Runs inspection or explicit model preparation against one connection generation. */
+    async [collectionTopologyDbInspectionSymbol](operationArg) {
+        if (this.lifecycleState !== 'connected' ||
+            this.status !== 'connected' ||
+            !this.mongoDb ||
+            !this.mongoDbClient ||
+            this.mongoDb.client !== this.mongoDbClient) {
+            throw new SmartdataPersistenceError('unsupported_operation', 'Collection topology inspection requires a connected SmartdataDb.');
+        }
+        const lifecycleEpoch = this.lifecycleEpoch;
+        const mongoDb = this.mongoDb;
+        const mongoDbClient = this.mongoDbClient;
+        const connectionIsCurrent = () => this.lifecycleState === 'connected' &&
+            this.status === 'connected' &&
+            this.lifecycleEpoch === lifecycleEpoch &&
+            this.mongoDb === mongoDb &&
+            this.mongoDbClient === mongoDbClient &&
+            mongoDb.client === mongoDbClient;
+        let result;
+        try {
+            result = await operationArg(mongoDb, () => {
+                if (!connectionIsCurrent()) {
+                    throw new SmartdataPersistenceError('unsupported_operation', 'SmartData connection changed during operation.');
+                }
+            });
+        }
+        catch {
+            if (!connectionIsCurrent()) {
+                throw new SmartdataPersistenceError('unsupported_operation', 'SmartData connection changed during collection topology inspection.');
+            }
+            throw new SmartdataPersistenceError('unsupported_operation', 'Collection topology inspection failed.');
+        }
+        if (!connectionIsCurrent()) {
+            throw new SmartdataPersistenceError('unsupported_operation', 'SmartData connection changed during collection topology inspection.');
+        }
+        return result;
+    }
+    // handle table to class distribution
+    addCollection(SmartdataCollectionArg) {
+        this.smartdataCollectionMap.add(SmartdataCollectionArg);
+    }
+    /**
+     * Gets a collection's name and returns a SmartdataCollection instance
+     * @param nameArg
+     * @returns DbTable
+     */
+    async getSmartdataCollectionByName(nameArg) {
+        const resultCollection = await this.smartdataCollectionMap.find(async (dbTableArg) => {
+            return dbTableArg.collectionName === nameArg;
+        });
+        return resultCollection;
+    }
+    beginLifecycleOperation(operationArg) {
+        this.assertLifecycleOperationCanBegin(operationArg);
+        this.activeLifecycleOperation = operationArg;
+    }
+    assertLifecycleOperationCanBegin(operationArg) {
+        if (this.activeLifecycleOperation) {
+            throw new SmartdataPersistenceError('unsupported_operation', `Cannot start SmartData database ${operationArg} while ${this.activeLifecycleOperation} is still running.`);
+        }
+        if (operationArg === 'init' &&
+            (this.lifecycleState === 'connected' ||
+                this.lifecycleState === 'close_failed')) {
+            throw new SmartdataPersistenceError('unsupported_operation', `Cannot start SmartData database init while the existing client is ${this.lifecycleState}.`);
+        }
+    }
+    resolveDatabaseToDrop(optionsArg) {
+        const options = assertDataOptions(optionsArg, ['dropDatabase', 'timeoutMs']);
+        if (!Object.hasOwn(options, 'dropDatabase')) {
+            return undefined;
+        }
+        const dropDatabaseOptions = assertExactDataObject(options.dropDatabase, ['expectedDatabaseName'], 'SmartData dropDatabase options');
+        const expectedDatabaseName = dropDatabaseOptions.expectedDatabaseName;
+        if (typeof expectedDatabaseName !== 'string' ||
+            expectedDatabaseName.length === 0 ||
+            expectedDatabaseName.trim() !== expectedDatabaseName) {
+            throw new SmartdataPersistenceError('invalid_argument', 'SmartData expectedDatabaseName must be a non-empty string without surrounding whitespace.');
+        }
+        if (this.lifecycleState !== 'connected' ||
+            this.status !== 'connected' ||
+            !this.mongoDbClient ||
+            !this.mongoDb) {
+            throw new SmartdataPersistenceError('unsupported_operation', 'SmartData can remove a database only from a connected lifecycle.');
+        }
+        if (this.mongoDb.client !== this.mongoDbClient) {
+            throw new SmartdataPersistenceError('invalid_configuration', 'SmartData database and client bindings are inconsistent.');
+        }
+        const boundDatabaseName = this.mongoDb.databaseName;
+        if (expectedDatabaseName !== boundDatabaseName) {
+            throw new SmartdataPersistenceError('invalid_argument', 'SmartData expectedDatabaseName does not match the connected database.');
+        }
+        if (this.smartdataOptions.mongoDbName !== boundDatabaseName) {
+            throw new SmartdataPersistenceError('invalid_configuration', 'SmartData database descriptor no longer matches the connected database.');
+        }
+        return this.mongoDb;
+    }
+    endLifecycleOperation(operationArg) {
+        if (this.activeLifecycleOperation === operationArg) {
+            this.activeLifecycleOperation = null;
+        }
+    }
+    transitionLifecycle(stateArg) {
+        this.lifecycleState = stateArg;
+        this.lifecycleEpoch++;
+    }
+    getReadinessLifecycleReason() {
+        switch (this.lifecycleState) {
+            case 'initial':
+                return 'not_initialized';
+            case 'connecting':
+                return 'connecting';
+            case 'connection_failed':
+                return 'connection_failed';
+            case 'closing':
+                return 'closing';
+            case 'closed':
+                return 'closed';
+            case 'close_failed':
+                return 'close_failed';
+            case 'connected':
+                return undefined;
+        }
+    }
+    createReadinessFailure(reasonArg, startedAtArg) {
+        return {
+            ready: false,
+            status: 'unavailable',
+            reason: reasonArg,
+            durationMs: performance.now() - startedAtArg,
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5kYi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL25vc3FsZGIvY2xhc3Nlcy5kYi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUV4QyxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUM5RCxPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDbkQsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDckUsT0FBTyxFQUFFLDRCQUE0QixFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFDaEYsT0FBTyxFQUNMLHNCQUFzQixFQUN0QiwyQkFBMkIsRUFDM0IsZ0JBQWdCLEVBQ2hCLHdDQUF3QyxHQUN6QyxNQUFNLHNCQUFzQixDQUFDO0FBQzlCLE9BQU8sRUFBRSxvQ0FBb0MsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQ3ZGLE9BQU8sRUFDTCx5QkFBeUIsR0FHMUIsTUFBTSxrQ0FBa0MsQ0FBQztBQUUxQyxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUd4RCxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sY0FBYyxDQUFDO0FBQ3RDLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSx3QkFBd0IsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBNkQzRixNQUFNLHlCQUF5QixHQUFHLEtBQUssQ0FBQztBQUN4QyxNQUFNLHlCQUF5QixHQUFHLE1BQU0sQ0FBQztBQUV6QyxNQUFNLHFCQUFxQixHQUFHLENBQzVCLFFBQWlCLEVBQ2pCLGVBQWtDLEVBQ2xDLGNBQXNCLEVBQ3RCLGFBQWEsR0FBRyxLQUFLLEVBQ0ksRUFBRTtJQUMzQixJQUNFLFFBQVEsS0FBSyxJQUFJO1FBQ2pCLE9BQU8sUUFBUSxLQUFLLFFBQVE7UUFDNUIsS0FBSyxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUM7UUFD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

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

@@ -0,0 +1,52 @@
+import * as plugins from './plugins.js';
+import { SmartdataDb } from './classes.db.js';
+import { SmartDataDbDoc } from './classes.doc.js';
+import { SmartdataDbWatcher } from './classes.watcher.js';
+export declare class DistributedClass extends SmartDataDbDoc<DistributedClass, DistributedClass> {
+    id: string;
+    data: {
+        status: 'initializing' | 'bidding' | 'settled' | 'stopped';
+        biddingShortcode?: string;
+        biddingStartTime?: number;
+        lastUpdated: number;
+        elected: boolean;
+        /**
+         * used to store request
+         */
+        taskRequests: plugins.taskbuffer.distributedCoordination.IDistributedTaskRequest[];
+        /**
+         * only used by the leader to convey consultation results
+         */
+        taskRequestResults: plugins.taskbuffer.distributedCoordination.IDistributedTaskRequestResult[];
+    };
+}
+/**
+ * This file implements a distributed coordinator according to the @pushrocks/taskbuffer standard.
+ * you should not set up this yourself. Instead, there is a factory on the SmartdataDb class
+ * that will take care of setting this up.
+ */
+export declare class SmartdataDistributedCoordinator extends plugins.taskbuffer.distributedCoordination
+    .AbstractDistributedCoordinator {
+    readyPromise: Promise<any>;
+    db: SmartdataDb;
+    private asyncExecutionStack;
+    ownInstance: DistributedClass;
+    distributedWatcher: SmartdataDbWatcher<DistributedClass>;
+    constructor(dbArg: SmartdataDb);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    id: string;
+    private startHeartbeat;
+    sendHeartbeat(): Promise<void>;
+    private init;
+    getEligibleLeader(): Promise<DistributedClass | undefined>;
+    checkAndMaybeLead(): Promise<void>;
+    /**
+     * when it has been determined
+     * that this instance is leading
+     * the leading is implemented here
+     */
+    leadFunction(): Promise<void>;
+    fireDistributedTaskRequest(taskRequestArg: plugins.taskbuffer.distributedCoordination.IDistributedTaskRequest): Promise<plugins.taskbuffer.distributedCoordination.IDistributedTaskRequestResult>;
+    updateDistributedTaskRequest(infoBasisArg: plugins.taskbuffer.distributedCoordination.IDistributedTaskRequest): Promise<void>;
+}