import type { TBlackHole, TContext } from "@digital-alchemy/core";
import type { TRawDomains } from "@digital-alchemy/hass";
import type { EmptyObject } from "type-fest";
import type { EntityConfigCommon, NonReactive } from "./common-config.mts";
import type { TSynapseId } from "./utility.mts";
export type RemovableCallback<DATA extends unknown = unknown> = (data: DATA, remove: () => void) => TBlackHole;
export type TSerialize<CONFIGURATION extends object = object, SERIALIZE_TYPES extends unknown = unknown> = {
    serialize: (property: keyof CONFIGURATION, data: SERIALIZE_TYPES, options: CONFIGURATION) => string;
    unserialize: (property: keyof CONFIGURATION, data: string, options: CONFIGURATION) => SERIALIZE_TYPES;
};
export type CreateRemovableCallback<DATA extends unknown = unknown> = (callback: RemovableCallback<DATA>) => {
    remove: () => void;
};
export type DomainGeneratorOptions<CONFIGURATION extends object, EVENT_MAP extends Record<string, object>, SERIALIZE_TYPES extends unknown = unknown> = {
    /**
     * The domain to map the code to on the python side
     */
    domain: TRawDomains;
    /**
     * Context of the synapse extension generating
     */
    context: TContext;
    /**
     * Bus Transfer events
     */
    bus_events?: Extract<keyof EVENT_MAP, string>[];
    /**
     * Keys to map from `add_entity` options -> `proxy.configuration`
     */
    load_config_keys?: Extract<keyof CONFIGURATION, string>[];
    /**
     * What to use instead of `undefined` / `None`
     */
    default_config?: Partial<CONFIGURATION>;
    /**
     * run as part of the setter process
     *
     * ensure that data is valid before handing off to internals
     */
    validate?: (current: CONFIGURATION, key: keyof CONFIGURATION, value: unknown) => void | never;
} & (TSerialize<CONFIGURATION, SERIALIZE_TYPES> | EmptyObject);
export type TEventMap = Record<string, object>;
export type AddEntityOptions<CONFIGURATION extends object, EVENT_MAP extends Record<string, object>, ATTRIBUTES extends object, LOCALS extends object, DATA extends object> = {
    context: TContext;
} & EntityConfigCommon<ATTRIBUTES, LOCALS, DATA> & CONFIGURATION & Partial<{
    [EVENT in keyof EVENT_MAP]: RemovableCallback<EVENT_MAP[EVENT]>;
}>;
export declare function generateHash(input: string): string;
export type BaseEvent = {
    data: {
        unique_id: TSynapseId;
    };
};
export declare const formatObjectId: (input: string) => string;
export declare const LATE_READY = -1;
export type CallbackData<LOCALS extends object, ATTRIBUTES extends object, EXTRA extends object = {}> = {
    locals: LOCALS;
    attributes: ATTRIBUTES;
} & NonReactive<Omit<EXTRA, "managed">>;