/*!
 * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
 * Licensed under the MIT License.
 */
import type { OpaqueJsonDeserialized } from "@fluidframework/core-interfaces/internal/exposedUtilityTypes";
/**
 * Collection of value types that are not intended to be used/imported
 * directly outside of this package.
 *
 * @public
 * @system
 */
export declare namespace InternalTypes {
    /**
     * Metadata for a value state.
     *
     * @system
     */
    interface ValueStateMetadata {
        rev: number;
        timestamp: number;
    }
    /**
     * Represents a state that may have a value.
     * And it includes standard metadata.
     *
     * @see {@link InternalPresenceTypes.ValueRequiredState}.
     *
     * @system
     */
    interface ValueOptionalState<TValue> extends ValueStateMetadata {
        value?: OpaqueJsonDeserialized<TValue>;
    }
    /**
     * Represents a state that must have a value.
     * And it includes standard metadata.
     *
     * @remarks
     * The value is wrapped in `OpaqueJsonDeserialized` as uses are expected
     * to involve generic or unknown types that will be filtered. It is here
     * mostly as a convenience to the many such uses that would otherwise
     * need to specify some wrapper themselves.
     *
     * For known cases, construct a custom interface that extends
     * {@link InternalPresenceTypes.ValueStateMetadata}.
     *
     * @system
     */
    interface ValueRequiredState<TValue> extends ValueStateMetadata {
        value: OpaqueJsonDeserialized<TValue>;
    }
    /**
     * A directory of values, where each value may be an optional state or another directory.
     *
     * @system
     */
    interface ValueDirectory<T> {
        rev: number;
        items: {
            [name: string | number]: ValueOptionalState<T> | ValueDirectory<T>;
        };
    }
    /**
     * Convenience type for a required state or a directory of values.
     *
     * @system
     */
    type ValueDirectoryOrState<T> = ValueRequiredState<T> | ValueDirectory<T>;
    /**
     * Collection of optional values in a "map" structure.
     *
     * @system
     */
    interface MapValueState<T, Keys extends string> {
        rev: number;
        items: {
            [name in Keys]: ValueOptionalState<T>;
        };
    }
    /**
     * Opaque type representing internal state datastore.
     *
     * @system
     */
    class StateDatastoreHandle<TKey, TValue extends ValueDirectoryOrState<unknown>> {
        private readonly StateDatastoreHandle;
    }
    /**
     * Brand to ensure state values internal type safety without revealing
     * internals that are subject to change.
     *
     * @system
     */
    class StateValueBrand<T> {
        private readonly StateValue;
    }
    /**
     * This type provides no additional functionality over the type it wraps.
     * It is used to ensure type safety within package.
     * Users may find it convenient to just use the type it wraps directly.
     *
     * @privateRemarks
     * Checkout filtering omitting unknown from T (`Omit<T,unknown> &`).
     *
     * @system
     */
    type StateValue<T> = T & StateValueBrand<T>;
    /**
     * Package internal function declaration for state and notification instantiation.
     *
     * @remarks
     * Direct use of this type is discouraged. If in need, try to use the type
     * returned by the factory functions instead, as those are more specific and
     * stable.
     *
     * @system
     */
    type ManagerFactory<TKey extends string, TValue extends ValueDirectoryOrState<unknown>, TManager> = {
        instanceBase: new (...args: any[]) => unknown;
    } & ((key: TKey, datastoreHandle: StateDatastoreHandle<TKey, TValue>) => {
        initialData?: {
            value: TValue;
            allowableUpdateLatencyMs: number | undefined;
        };
        manager: StateValue<TManager>;
    });
    /**
     * Structure of a generic notification "value".
     *
     * @system
     */
    interface NotificationType {
        name: string;
        args: unknown[];
    }
}
//# sourceMappingURL=exposedInternalTypes.d.ts.map