@lossless.org/nosqldb 8.0.0

package/dist_ts/ts_nosqldb/rust-db-bridge.js

@@ -0,0 +1,439 @@
+import * as plugins from './plugins.js';
+import { normalizeNoSqlDbFileStorageOptions } from './file-storage-options.js';
+import * as path from 'path';
+import * as url from 'url';
+import { EventEmitter } from 'events';
+import { normalizeNoSqlDbStorageRehearsalInput, } from './storage-rehearsal.js';
+import { normalizeNoSqlDbAllocationReadAccessGrantError, normalizeNoSqlDbResourceFenceError, } from './service-types.js';
+import { normalizeLocalNoSqlDbOfflinePhysicalNamespaceInspectionInput, normalizeLocalNoSqlDbOfflineInspectionInput, validateNoSqlDbManagementOperationOptions, } from './offline-inspection.js';
+import { normalizeLocalNoSqlDbStoppedStorageRootRelocationInput, } from './storage-root-relocation.js';
+export class NoSqlDbManagementOperationTerminationError extends AggregateError {
+    constructor(operationErrorArg, terminationErrorArg) {
+        super([operationErrorArg, terminationErrorArg], 'NoSQLDB management operation failed and Rust engine termination was incomplete', { cause: operationErrorArg });
+        this.name = 'NoSqlDbManagementOperationTerminationError';
+    }
+}
+export const rustDbBridgeStorageRootRelocation = Symbol('nosqldb.internal.storage-root-relocation');
+export const rustDbBridgeStorageRehearsal = Symbol('nosqldb.internal.storage-rehearsal');
+/**
+ * Get the package root directory using import.meta.url.
+ * This file is at ts/ts_nosqldb/, so package root is 2 levels up.
+ */
+function getPackageRoot() {
+    const thisDir = path.dirname(url.fileURLToPath(import.meta.url));
+    return path.resolve(thisDir, '..', '..');
+}
+/**
+ * Map Node.js process.platform/process.arch to tsrust's friendly name suffix.
+ * tsrust names cross-compiled binaries as: rustdb_linux_amd64, rustdb_linux_arm64, etc.
+ */
+function getTsrustPlatformSuffix() {
+    const archMap = { x64: 'amd64', arm64: 'arm64' };
+    const osMap = { linux: 'linux', darwin: 'macos' };
+    const os = osMap[process.platform];
+    const arch = archMap[process.arch];
+    if (os && arch) {
+        return `${os}_${arch}`;
+    }
+    return null;
+}
+/**
+ * Build local search paths for the Rust binary, including dist_rust/ candidates
+ * (built by tsrust) and local development build paths.
+ */
+function buildLocalPaths() {
+    const packageRoot = getPackageRoot();
+    const suffix = getTsrustPlatformSuffix();
+    const paths = [];
+    // dist_rust/ candidates (tsrust cross-compiled output)
+    if (suffix) {
+        paths.push(path.join(packageRoot, 'dist_rust', `rustdb_${suffix}`));
+    }
+    paths.push(path.join(packageRoot, 'dist_rust', 'rustdb'));
+    // Local dev build paths
+    paths.push(path.resolve(process.cwd(), 'rust', 'target', 'release', 'rustdb'));
+    paths.push(path.resolve(process.cwd(), 'rust', 'target', 'debug', 'rustdb'));
+    return paths;
+}
+export function getRustDbAllocatorEnv(environment = process.env) {
+    return {
+        MIMALLOC_ARENA_EAGER_COMMIT: environment.MIMALLOC_ARENA_EAGER_COMMIT ?? '0',
+        MIMALLOC_ALLOW_LARGE_OS_PAGES: environment.MIMALLOC_ALLOW_LARGE_OS_PAGES ?? '0',
+    };
+}
+/**
+ * Bridge between TypeScript NoSqlDbServer and the Rust binary.
+ * Wraps @push.rocks/smartrust's RustBridge with type-safe command definitions.
+ */
+export class RustDbBridge extends EventEmitter {
+    /**
+     * Operating-system process id of the spawned Rust engine while it runs as a
+     * child process of this Node.js process. Undefined before spawn, after
+     * termination, or when the bridge is connected to an external process.
+     */
+    get processId() {
+        const transport = this.bridge.transport;
+        return transport?.childProcess?.pid;
+    }
+    constructor(options = {}) {
+        super();
+        this.terminationConfirmed = true;
+        this.bridge = new plugins.smartrust.RustBridge({
+            binaryName: 'rustdb',
+            binaryPath: options.binaryPath,
+            envVarName: 'NOSQLDB_RUST_BINARY',
+            platformPackagePrefix: '@lossless.org/nosqldb',
+            localPaths: buildLocalPaths(),
+            maxPayloadSize: 100 * 1024 * 1024, // database exports/imports can be larger than command replies
+            env: getRustDbAllocatorEnv(),
+        });
+        // Forward events from the inner bridge
+        this.bridge.on('exit', (code, signal) => {
+            this.terminationConfirmed = true;
+            this.emit('exit', code, signal);
+        });
+    }
+    /**
+     * Spawn the Rust binary in management mode.
+     * Returns true if the binary was found and spawned successfully.
+     */
+    async spawn(optionsArg) {
+        validateNoSqlDbManagementOperationOptions(optionsArg);
+        if (optionsArg?.signal?.aborted) {
+            throw new plugins.smartrust.RustBridgeRequestError('NoSQLDB Rust sidecar spawn was aborted before it started', {
+                code: 'ERR_RUST_BRIDGE_REQUEST_ABORTED',
+                method: 'spawn',
+                cause: optionsArg.signal.reason,
+            });
+        }
+        this.terminationConfirmed = false;
+        this.terminationFailure = undefined;
+        const spawnPromise = this.bridge.spawn();
+        let timeout;
+        let abortHandler;
+        const cancellationPromise = new Promise((_resolveArg, rejectArg) => {
+            if (optionsArg?.timeoutMs !== undefined) {
+                timeout = setTimeout(() => {
+                    rejectArg(new plugins.smartrust.RustBridgeRequestError(`NoSQLDB Rust sidecar spawn timed out after ${optionsArg.timeoutMs}ms`, {
+                        code: 'ERR_RUST_BRIDGE_REQUEST_TIMEOUT',
+                        method: 'spawn',
+                    }));
+                }, optionsArg.timeoutMs);
+            }
+            if (optionsArg?.signal) {
+                abortHandler = () => {
+                    rejectArg(new plugins.smartrust.RustBridgeRequestError('NoSQLDB Rust sidecar spawn was aborted', {
+                        code: 'ERR_RUST_BRIDGE_REQUEST_ABORTED',
+                        method: 'spawn',
+                        cause: optionsArg.signal.reason,
+                    }));
+                };
+                optionsArg.signal.addEventListener('abort', abortHandler, { once: true });
+            }
+        });
+        try {
+            const spawned = await Promise.race([spawnPromise, cancellationPromise]);
+            if (!spawned) {
+                await this.terminate({ gracePeriodMs: 0 });
+            }
+            return spawned;
+        }
+        catch (error) {
+            try {
+                await this.terminate({ gracePeriodMs: 0 });
+            }
+            catch (terminationError) {
+                throw new NoSqlDbManagementOperationTerminationError(error, terminationError);
+            }
+            throw error;
+        }
+        finally {
+            if (timeout)
+                clearTimeout(timeout);
+            if (abortHandler && optionsArg?.signal) {
+                optionsArg.signal.removeEventListener('abort', abortHandler);
+            }
+        }
+    }
+    /**
+     * Kill the Rust process and clean up.
+     */
+    kill() {
+        this.bridge.kill();
+    }
+    /**
+     * Confirm that the Rust process has exited and all bridge resources are released.
+     */
+    terminate(optionsArg) {
+        if (this.terminationPromise) {
+            return this.terminationPromise;
+        }
+        const terminationPromise = this.bridge.terminate(optionsArg).then(() => {
+            this.terminationConfirmed = true;
+            this.terminationFailure = undefined;
+        }, (errorArg) => {
+            this.terminationFailure = errorArg;
+            throw errorArg;
+        });
+        this.terminationPromise = terminationPromise;
+        void terminationPromise.then(() => {
+            if (this.terminationPromise === terminationPromise) {
+                this.terminationPromise = undefined;
+            }
+        }, () => {
+            if (this.terminationPromise === terminationPromise) {
+                this.terminationPromise = undefined;
+            }
+        });
+        return terminationPromise;
+    }
+    /**
+     * Whether the bridge is currently running.
+     */
+    get running() {
+        return this.bridge.running;
+    }
+    get ownershipReleased() {
+        return this.terminationConfirmed;
+    }
+    async awaitManagementOperationTermination(errorArg) {
+        const cancellationRequiresTermination = errorArg instanceof plugins.smartrust.RustBridgeRequestError
+            && [
+                'ERR_RUST_BRIDGE_REQUEST_ABORTED',
+                'ERR_RUST_BRIDGE_REQUEST_TIMEOUT',
+            ].includes(errorArg.code);
+        let terminationPromise = this.terminationPromise;
+        if (cancellationRequiresTermination && !terminationPromise) {
+            terminationPromise = this.terminate({ gracePeriodMs: 0 });
+        }
+        if (!terminationPromise) {
+            if (!this.terminationConfirmed && this.terminationFailure !== undefined) {
+                throw new NoSqlDbManagementOperationTerminationError(errorArg, this.terminationFailure);
+            }
+            return;
+        }
+        try {
+            await terminationPromise;
+        }
+        catch (terminationError) {
+            throw new NoSqlDbManagementOperationTerminationError(errorArg, terminationError);
+        }
+    }
+    // --- Convenience methods for each management command ---
+    async [rustDbBridgeStorageRehearsal](inputArg, optionsArg) {
+        const request = normalizeNoSqlDbStorageRehearsalInput(inputArg);
+        validateNoSqlDbManagementOperationOptions(optionsArg);
+        try {
+            return await this.bridge.sendCommand('createStoppedStorageRehearsal', { request, timeoutMs: optionsArg.timeoutMs }, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw error;
+        }
+    }
+    async [rustDbBridgeStorageRootRelocation](inputArg, optionsArg) {
+        const input = normalizeLocalNoSqlDbStoppedStorageRootRelocationInput(inputArg);
+        validateNoSqlDbManagementOperationOptions(optionsArg);
+        try {
+            return await this.bridge.sendCommand('relocateStoppedStorageRoot', { ...input, timeoutMs: optionsArg?.timeoutMs }, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw error;
+        }
+    }
+    async inspectOfflinePhysicalNamespaces(inputArg, optionsArg) {
+        const input = normalizeLocalNoSqlDbOfflinePhysicalNamespaceInspectionInput(inputArg);
+        validateNoSqlDbManagementOperationOptions(optionsArg);
+        const params = {
+            folderPath: input.folderPath,
+            ...input.limits,
+            timeoutMs: optionsArg?.timeoutMs,
+        };
+        try {
+            return await this.bridge.sendCommand('inspectOfflinePhysicalNamespaces', params, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw error;
+        }
+    }
+    async inspectOfflineStringValue(inputArg, optionsArg) {
+        const input = normalizeLocalNoSqlDbOfflineInspectionInput(inputArg);
+        validateNoSqlDbManagementOperationOptions(optionsArg);
+        try {
+            return await this.bridge.sendCommand('inspectOfflineStringValue', { ...input, timeoutMs: optionsArg?.timeoutMs }, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw error;
+        }
+    }
+    async startDb(config, optionsArg) {
+        normalizeNoSqlDbFileStorageOptions(config);
+        validateNoSqlDbManagementOperationOptions(optionsArg);
+        try {
+            return await this.bridge.sendCommand('start', { config, timeoutMs: optionsArg?.timeoutMs }, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw error;
+        }
+    }
+    async stopDb() {
+        await this.bridge.sendCommand('stop', {});
+    }
+    async getStatus() {
+        return await this.bridge.sendCommand('getStatus', {});
+    }
+    async getMetrics() {
+        return this.bridge.sendCommand('getMetrics', {});
+    }
+    async getHealth(optionsArg) {
+        try {
+            return await this.bridge.sendCommand('getHealth', {}, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw error;
+        }
+    }
+    async createDatabaseTenant(params) {
+        try {
+            return await this.bridge.sendCommand('createDatabaseTenant', params);
+        }
+        catch (error) {
+            throw normalizeNoSqlDbResourceFenceError(error);
+        }
+    }
+    async ensureDatabaseTenant(params, optionsArg) {
+        try {
+            return await this.bridge.sendCommand('ensureDatabaseTenant', params, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw normalizeNoSqlDbResourceFenceError(error);
+        }
+    }
+    async attestDatabaseTenant(params, optionsArg) {
+        try {
+            return await this.bridge.sendCommand('attestDatabaseTenant', params, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw normalizeNoSqlDbResourceFenceError(error);
+        }
+    }
+    async allocateDatabaseTenant(params, optionsArg) {
+        try {
+            return await this.bridge.sendCommand('allocateDatabaseTenant', params, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw normalizeNoSqlDbResourceFenceError(error);
+        }
+    }
+    async deleteDatabaseTenant(params, optionsArg) {
+        try {
+            return await this.bridge.sendCommand('deleteDatabaseTenant', params, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw normalizeNoSqlDbResourceFenceError(error);
+        }
+    }
+    async issueDatabaseAllocationReadAccessGrant(params, optionsArg) {
+        try {
+            return await this.bridge.sendCommand('issueDatabaseAllocationReadAccessGrant', params, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw normalizeNoSqlDbAllocationReadAccessGrantError(normalizeNoSqlDbResourceFenceError(error), error instanceof plugins.smartrust.RustBridgeRequestError
+                ? error.responseErrorCode
+                : undefined);
+        }
+    }
+    async revokeDatabaseAllocationReadAccessGrant(params, optionsArg) {
+        try {
+            return await this.bridge.sendCommand('revokeDatabaseAllocationReadAccessGrant', params, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw normalizeNoSqlDbAllocationReadAccessGrantError(normalizeNoSqlDbResourceFenceError(error), error instanceof plugins.smartrust.RustBridgeRequestError
+                ? error.responseErrorCode
+                : undefined);
+        }
+    }
+    async rotateDatabaseTenantPassword(params) {
+        return this.bridge.sendCommand('rotateDatabaseTenantPassword', params);
+    }
+    async listDatabaseTenants() {
+        const result = await this.bridge.sendCommand('listDatabaseTenants', {});
+        return result.tenants;
+    }
+    async getDatabaseTenantDescriptor(params) {
+        return this.bridge.sendCommand('getDatabaseTenantDescriptor', params);
+    }
+    async getDatabaseResourceFenceState(params, optionsArg) {
+        try {
+            return await this.bridge.sendCommand('getDatabaseResourceFenceState', params, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw normalizeNoSqlDbResourceFenceError(error);
+        }
+    }
+    async exportDatabase(params, optionsArg) {
+        try {
+            return await this.bridge.sendCommand('exportDatabase', params, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw error;
+        }
+    }
+    async getDatabaseContentDigest(params, optionsArg) {
+        try {
+            return await this.bridge.sendCommand('getDatabaseContentDigest', params, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw error;
+        }
+    }
+    async importDatabase(params, optionsArg) {
+        try {
+            return await this.bridge.sendCommand('importDatabase', { ...params, timeoutMs: optionsArg?.timeoutMs }, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw normalizeNoSqlDbResourceFenceError(error);
+        }
+    }
+    async commitDatabasePublication(params, optionsArg) {
+        try {
+            return await this.bridge.sendCommand('commitDatabasePublication', params, optionsArg);
+        }
+        catch (error) {
+            await this.awaitManagementOperationTermination(error);
+            throw normalizeNoSqlDbResourceFenceError(error);
+        }
+    }
+    async getOpLog(params = {}) {
+        return this.bridge.sendCommand('getOpLog', params);
+    }
+    async getOpLogStats() {
+        return this.bridge.sendCommand('getOpLogStats', {});
+    }
+    async revertToSeq(seq, dryRun = false) {
+        return this.bridge.sendCommand('revertToSeq', { seq, dryRun });
+    }
+    async getCollections(db) {
+        const result = await this.bridge.sendCommand('getCollections', db ? { db } : {});
+        return result.collections;
+    }
+    async getDocuments(db, collection, limit = 50, skip = 0) {
+        return this.bridge.sendCommand('getDocuments', { db, collection, limit, skip });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnVzdC1kYi1icmlkZ2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy90c19ub3NxbGRiL3J1c3QtZGItYnJpZGdlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sRUFBRSxrQ0FBa0MsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQy9FLE9BQU8sS0FBSyxJQUFJLE1BQU0sTUFBTSxDQUFDO0FBQzdCLE9BQU8sS0FBSyxHQUFHLE1BQU0sS0FBSyxDQUFDO0FBQzNCLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxRQUFRLENBQUM7QUFDdEMsT0FBTyxFQUNMLHFDQUFxQyxHQUl0QyxNQUFNLHdCQUF3QixDQUFDO0FBQ2hDLE9BQU8sRUFDTCw4Q0FBOEMsRUFDOUMsa0NBQWtDLEdBQ25DLE1BQU0sb0JBQW9CLENBQUM7QUFDNUIsT0FBTyxFQUNMLDREQUE0RCxFQUM1RCwyQ0FBMkMsRUFDM0MseUNBQXlDLEdBQzFDLE1BQU0seUJBQXlCLENBQUM7QUFDakMsT0FBTyxFQUNMLHNEQUFzRCxHQUd2RCxNQUFNLDhCQUE4QixDQUFDO0FBd0l0QyxNQUFNLE9BQU8sMENBQTJDLFNBQVEsY0FBYztJQUM1RSxZQUFZLGlCQUEwQixFQUFFLG1CQUE0QjtRQUNsRSxLQUFLLENBQ0gsQ0FBQyxpQkFBaUIsRUFBRSxtQkFBbUIsQ0FBQyxFQUN4QyxnRkFBZ0YsRUFDaEYsRUFBRSxLQUFLLEVBQUUsaUJBQWlCLEVBQUUsQ0FDN0IsQ0FBQztRQUNGLElBQUksQ0FBQyxJQUFJLEdBQUcsNENBQTRDLENBQUM7SUFDM0QsQ0FBQztDQUNGO0FBOEhELE1BQU0sQ0FBQyxNQUFNLGlDQUFpQyxHQUFHLE1BQU0sQ0FDckQsMENBQTBDLENBQzNDLENBQUM7QUFDRixNQUFNLENBQUMsTUFBTSw0QkFBNEIsR0FBRyxNQUFNLENBQUMsb0NBQW9DLENBQUMsQ0FBQztBQTZDekY7OztHQUdH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

package/dist_ts/ts_nosqldb/server/classes.nosqldbserver.d.ts

@@ -0,0 +1,204 @@
+import { type TNoSqlDbFileStorageStartup } from '../file-storage-startup.js';
+import type { IOpLogResult, IOpLogStats, IRevertResult, ICollectionInfo, IDocumentsResult, INoSqlDbMetrics, INoSqlDbQueryOptions } from '../rust-db-bridge.js';
+import type { INoSqlDbHealth, INoSqlDbDatabaseTenantInput, INoSqlDbAttestDatabaseTenantInput, INoSqlDbAttestDatabaseTenantResult, INoSqlDbEnsureDatabaseTenantInput, INoSqlDbEnsureDatabaseTenantResult, INoSqlDbAllocateDatabaseTenantInput, INoSqlDbAllocateDatabaseTenantResult, INoSqlDbDeleteDatabaseTenantInput, INoSqlDbRotateDatabaseTenantPasswordInput, INoSqlDbDatabaseTenantDescriptor, INoSqlDbDeleteDatabaseTenantResult, INoSqlDbIssueDatabaseAllocationReadAccessGrantInput, INoSqlDbIssueDatabaseAllocationReadAccessGrantResult, INoSqlDbRevokeDatabaseAllocationReadAccessGrantInput, INoSqlDbRevokeDatabaseAllocationReadAccessGrantResult, INoSqlDbDatabaseExport, INoSqlDbExportDatabaseInput, INoSqlDbDatabaseContentDigest, INoSqlDbGetDatabaseContentDigestInput, INoSqlDbImportDatabaseInput, INoSqlDbImportDatabaseResult, INoSqlDbCommitDatabasePublicationInput, INoSqlDbManagementOperationOptions, INoSqlDbDatabaseResourceFenceState, TNoSqlDbCommitDatabasePublicationResult } from '../service-types.js';
+/**
+ * Server configuration options
+ */
+export interface INoSqlDbServerOptions {
+    /** Exact engine executable. Invalid explicit paths reject without chmod or discovery fallback. Omit for normal discovery. */
+    binaryPath?: string;
+    /** Exact rehearsal operation ID. Requires authenticated current-format-only file storage and an explicit private Unix socket. Never promotes a rehearsal. */
+    storageRehearsalId?: string;
+    /** Default: current-format-only. The native owner rejects foreign, mixed and migration staging roots without conversion. */
+    fileStorageStartup?: TNoSqlDbFileStorageStartup;
+    /** Port to listen on (default: 27017, 0 requests an OS-assigned port) - ignored if socketPath is set */
+    port?: number;
+    /** Host to bind to (default: 127.0.0.1) - ignored if socketPath is set */
+    host?: string;
+    /** Unix socket path - if set, server listens on socket instead of TCP */
+    socketPath?: string;
+    /** Storage type: 'memory' or 'file' (default: 'memory') */
+    storage?: 'memory' | 'file';
+    /** Path for file storage (required if storage is 'file') */
+    storagePath?: string;
+    /** Authentication configuration. Disabled by default. */
+    auth?: INoSqlDbAuthOptions;
+    /** TLS transport configuration for TCP listeners. Disabled by default. */
+    tls?: INoSqlDbTlsOptions;
+    /** In-memory oplog retention limits (defaults: 10000 entries / 64 MiB). */
+    oplog?: INoSqlDbOplogOptions;
+    /** Memory, temporary storage, and concurrency admission for large sorts. */
+    query?: INoSqlDbQueryOptions;
+}
+export interface INoSqlDbOplogOptions {
+    /** Maximum number of retained oplog entries (default: 10000). */
+    maxEntries?: number;
+    /** Maximum approximate retained bytes (default: 64 MiB). Oldest entries are evicted first; reverts cannot reach past evicted entries. */
+    maxBytes?: number;
+}
+export interface INoSqlDbAuthOptions {
+    enabled?: boolean;
+    users?: INoSqlDbAuthUser[];
+    scramIterations?: number;
+}
+export interface INoSqlDbAuthUser {
+    username: string;
+    password: string;
+    database?: string;
+    roles?: string[];
+}
+export interface INoSqlDbTlsOptions {
+    enabled?: boolean;
+    certPath?: string;
+    keyPath?: string;
+    caPath?: string;
+    requireClientCert?: boolean;
+}
+/**
+ * NoSqlDbServer - Wire protocol compatible database server backed by Rust
+ *
+ * This server implements the wire protocol to allow official drivers to
+ * connect and perform operations. The core engine runs as a Rust sidecar
+ * binary managed via @push.rocks/smartrust IPC.
+ *
+ * @example
+ * ```typescript
+ * import { NoSqlDbServer } from '@lossless.org/nosqldb';
+ * import { MongoClient } from 'mongodb';
+ *
+ * const server = new NoSqlDbServer({ port: 27017 });
+ * await server.start();
+ *
+ * const client = new MongoClient(server.getConnectionUri());
+ * await client.connect();
+ * ```
+ */
+export declare class NoSqlDbServer {
+    private options;
+    private bridge;
+    private bridgeOwned;
+    private startInProgress;
+    private startCompletionPromise;
+    private isRunning;
+    private resolvedConnectionUri;
+    private resolvedPort;
+    constructor(options?: INoSqlDbServerOptions);
+    /**
+     * Start the server
+     */
+    start(optionsArg?: INoSqlDbManagementOperationOptions): Promise<void>;
+    /**
+     * Stop the server
+     */
+    stop(): Promise<void>;
+    /**
+     * Get the connection URI for this server
+     */
+    getConnectionUri(): string;
+    /**
+     * Get the socket path (if using Unix socket mode)
+     */
+    get socketPath(): string | undefined;
+    /**
+     * Check if the server is running
+     */
+    /** Process id of the spawned Rust engine, when it runs as a child process. */
+    get processId(): number | undefined;
+    get running(): boolean;
+    private runDatabaseManagementOperation;
+    /**
+     * Get the port the server is listening on
+     */
+    get port(): number;
+    /**
+     * Get the host the server is bound to
+     */
+    get host(): string;
+    /**
+     * Create an isolated database/user pair for an application tenant.
+     */
+    createDatabaseTenant(params: INoSqlDbDatabaseTenantInput): Promise<INoSqlDbDatabaseTenantDescriptor>;
+    /** Authoritatively allocate an absent, fenced database tenant. */
+    allocateDatabaseTenant(params: INoSqlDbAllocateDatabaseTenantInput, optionsArg?: INoSqlDbManagementOperationOptions): Promise<INoSqlDbAllocateDatabaseTenantResult>;
+    /**
+     * Idempotently provision or rotate one exclusively owned database tenant.
+     */
+    ensureDatabaseTenant(params: INoSqlDbEnsureDatabaseTenantInput, optionsArg?: INoSqlDbManagementOperationOptions): Promise<INoSqlDbEnsureDatabaseTenantResult>;
+    /** Verify an exact tenant credential without changing provider state. */
+    attestDatabaseTenant(params: INoSqlDbAttestDatabaseTenantInput, optionsArg?: INoSqlDbManagementOperationOptions): Promise<INoSqlDbAttestDatabaseTenantResult>;
+    /**
+     * Delete a tenant database and its tenant user(s).
+     */
+    deleteDatabaseTenant(params: INoSqlDbDeleteDatabaseTenantInput, optionsArg?: INoSqlDbManagementOperationOptions): Promise<INoSqlDbDeleteDatabaseTenantResult>;
+    /** Issue one fixed-expiry read grant bound to an exact active allocation. */
+    issueDatabaseAllocationReadAccessGrant(params: INoSqlDbIssueDatabaseAllocationReadAccessGrantInput, optionsArg?: INoSqlDbManagementOperationOptions): Promise<INoSqlDbIssueDatabaseAllocationReadAccessGrantResult>;
+    /** Idempotently revoke one allocation read grant without returning a secret. */
+    revokeDatabaseAllocationReadAccessGrant(params: INoSqlDbRevokeDatabaseAllocationReadAccessGrantInput, optionsArg?: INoSqlDbManagementOperationOptions): Promise<INoSqlDbRevokeDatabaseAllocationReadAccessGrantResult>;
+    /**
+     * Rotate a tenant user's password without restarting the server.
+     */
+    rotateDatabaseTenantPassword(params: INoSqlDbRotateDatabaseTenantPasswordInput): Promise<INoSqlDbDatabaseTenantDescriptor>;
+    /**
+     * List known database tenants.
+     */
+    listDatabaseTenants(): Promise<INoSqlDbDatabaseTenantDescriptor[]>;
+    /**
+     * Get a tenant descriptor without exposing a password.
+     */
+    getDatabaseTenantDescriptor(params: {
+        databaseName: string;
+        username: string;
+    }): Promise<INoSqlDbDatabaseTenantDescriptor>;
+    /** Inspect the durable high-water mark without exposing mutation receipts. */
+    getDatabaseResourceFenceState(params: {
+        databaseName: string;
+    }, optionsArg?: INoSqlDbManagementOperationOptions): Promise<INoSqlDbDatabaseResourceFenceState | null>;
+    /**
+     * Export one database as an Extended JSON snapshot.
+     */
+    exportDatabase(params: INoSqlDbExportDatabaseInput, optionsArg?: INoSqlDbManagementOperationOptions): Promise<INoSqlDbDatabaseExport>;
+    /** Compute a bounded, database-name-independent digest of logical database content. */
+    getDatabaseContentDigest(params: INoSqlDbGetDatabaseContentDigestInput, optionsArg?: INoSqlDbManagementOperationOptions): Promise<INoSqlDbDatabaseContentDigest>;
+    /**
+     * Replace one database with a previously exported snapshot.
+     */
+    importDatabase(params: INoSqlDbImportDatabaseInput, optionsArg?: INoSqlDbManagementOperationOptions): Promise<INoSqlDbImportDatabaseResult>;
+    /** Release an exact held database publication after downstream fsync. */
+    commitDatabasePublication(params: INoSqlDbCommitDatabasePublicationInput, optionsArg?: INoSqlDbManagementOperationOptions): Promise<TNoSqlDbCommitDatabasePublicationResult>;
+    /**
+     * Get readiness/health details for long-running service use.
+     */
+    getHealth(optionsArg?: INoSqlDbManagementOperationOptions): Promise<INoSqlDbHealth>;
+    /**
+     * Get oplog entries, optionally filtered.
+     */
+    getOpLog(params?: {
+        sinceSeq?: number;
+        limit?: number;
+        db?: string;
+        collection?: string;
+    }): Promise<IOpLogResult>;
+    /**
+     * Get aggregate oplog statistics.
+     */
+    getOpLogStats(): Promise<IOpLogStats>;
+    /**
+     * Revert database state to a specific oplog sequence number.
+     * Use dryRun=true to preview which entries would be reverted.
+     */
+    revertToSeq(seq: number, dryRun?: boolean): Promise<IRevertResult>;
+    /**
+     * List all collections across all databases, with document counts.
+     */
+    getCollections(db?: string): Promise<ICollectionInfo[]>;
+    /**
+     * Get documents from a collection with pagination.
+     */
+    getDocuments(db: string, collection: string, limit?: number, skip?: number): Promise<IDocumentsResult>;
+    /**
+     * Get server metrics including database/collection counts and oplog info.
+     */
+    getMetrics(): Promise<INoSqlDbMetrics>;
+    private withTenantMongoUri;
+    private buildTenantMongoUri;
+}