@digital-alchemy/core 0.1.0

package/dist/hass/dynamic.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENTITY_SETUP = void 0;
+/**
+ * ## THIS FILE IS INTENDED TO BE REPLACED
+ *
+ * ! IF YOU STILL SEE THIS IN YOUR `node_modules`, run `npx type-writer`
+ *
+ * The purpose it to represent the configuration of Home Assistant
+ *
+ * - entities, with their available attributes & states
+ * - services, and what parameters they take
+ *
+ * This information is TYPES ONLY, and is used to add type safety to
+ * methods exported from this library through the use of utility types that
+ * take advantage of this information
+ *
+ * A post-install hook will regenerate these with real values.
+ *
+ * The service definition is the switch, light, scene domains from a previously generated file.
+ * These are required to make typescript happy for internal library definitions
+ */
+exports.ENTITY_SETUP = {
+    binary_sensor: {
+        is_day: {
+            attributes: {
+                friendly_name: "Is day",
+            },
+            context: {
+                id: "01HNZ7RV5ZRHF4R6EVTX210Z82",
+                parent_id: null,
+                user_id: null,
+            },
+            entity_id: "binary_sensor.is_day",
+            last_changed: "2024-02-06T12:55:00.031067+00:00",
+            last_updated: "2024-02-06T12:55:00.031067+00:00",
+            state: "on",
+        },
+    },
+    button: {
+        click_me: {
+            attributes: {
+                friendly_name: "Click me",
+            },
+            context: {
+                id: "01HNZ7RV5ZRHF4R6EVTX210Z83",
+                parent_id: null,
+                user_id: null,
+            },
+            entity_id: "button.click_me",
+            last_changed: "2024-02-06T12:55:00.031068+00:00",
+        },
+    },
+    calendar: {
+        personal: {
+            attributes: {
+                friendly_name: "Personal",
+                offset_reached: false,
+            },
+            context: {
+                id: "01HJYK0H8P96SCF35ZVZGXKRT0",
+                parent_id: null,
+                user_id: null,
+            },
+            entity_id: "calendar.personal",
+            last_changed: "2023-12-31T00:00:06.145302+00:00",
+            last_updated: "2023-12-31T00:05:06.454423+00:00",
+            state: "off",
+        },
+    },
+    light: {
+        womp: {
+            attributes: {
+                brightness: 255,
+                color_mode: "color_temp",
+                color_temp: 253,
+                color_temp_kelvin: 3952,
+                dynamics: "none",
+                friendly_name: "Womp",
+                hs_color: [26.835, 35.746],
+                max_color_temp_kelvin: 6535,
+                max_mireds: 500,
+                min_color_temp_kelvin: 2000,
+                min_mireds: 153,
+                mode: "normal",
+                rgb_color: [255, 204, 163],
+                supported_color_modes: ["color_temp", "xy"],
+                supported_features: 40,
+                xy_color: [0.424, 0.366],
+            },
+            context: {
+                id: "01HK0TW9610XX5C5EZWE6ZEWJ0",
+                parent_id: null,
+                user_id: "72b5dc1d14484f9bb54df2de3ab95773",
+            },
+            entity_id: "light.womp",
+            last_changed: "2023-12-31T16:23:21.270862+00:00",
+            last_updated: "2023-12-31T21:01:05.179072+00:00",
+            state: "on",
+        },
+    },
+    scene: {
+        bedroom_auto: {
+            attributes: {
+                friendly_name: "Bedroom Auto",
+            },
+            context: {
+                id: "01HK02X46S76A2C7JJMENBHF55",
+                parent_id: null,
+                user_id: "72b5dc1d14484f9bb54df2de3ab95773",
+            },
+            entity_id: "scene.bedroom_auto",
+            last_changed: "2023-12-31T14:02:06.428935+00:00",
+            last_updated: "2023-12-31T14:02:06.428935+00:00",
+            state: "2023-12-31T14:02:06.428760+00:00",
+        },
+    },
+    sensor: {
+        loft_current_scene: {
+            attributes: {
+                friendly_name: "Loft current scene",
+                managed_by: "home-automation",
+                scene: "high",
+            },
+            context: {
+                id: "01HNZE7KCPMNXAK1N6G9MWC5M4",
+                parent_id: null,
+                user_id: null,
+            },
+            entity_id: "sensor.loft_current_scene",
+            last_changed: "2024-02-06T14:47:55.030369+00:00",
+            last_updated: "2024-02-06T14:47:55.030369+00:00",
+            state: "High",
+        },
+    },
+    switch: {
+        guest_mode: {
+            attributes: {
+                friendly_name: "Guest mode",
+            },
+            context: {
+                id: "01HK1AAJ4PW4SNPBFV35EDTJME",
+                parent_id: null,
+                user_id: "72b5dc1d14484f9bb54df2de3ab95773",
+            },
+            entity_id: "switch.guest_mode",
+            last_changed: "2024-01-01T01:25:47.375385+00:00",
+            last_updated: "2024-01-01T01:31:01.142980+00:00",
+            state: "off",
+        },
+    },
+};
+//# sourceMappingURL=dynamic.js.map

package/dist/hass/dynamic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic.js","sourceRoot":"","sources":["../../src/hass/dynamic.ts"],"names":[],"mappings":"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"}

package/dist/hass/extensions/call-proxy.extension.d.ts

@@ -0,0 +1,4 @@
+import { TServiceParams } from "../..";
+import { iCallService } from "..";
+export declare function CallProxy({ logger, lifecycle, context, hass, config, }: TServiceParams): iCallService;
+export default CallProxy;

package/dist/hass/extensions/call-proxy.extension.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CallProxy = void 0;
+const process_1 = require("process");
+const __1 = require("../..");
+const __2 = require("..");
+const FAILED_LOAD_DELAY = 5;
+const MAX_ATTEMPTS = 50;
+const FAILED = 1;
+const NOT_A_DOMAIN = new Set(["then"]);
+function CallProxy({ logger, lifecycle, context, hass, config, }) {
+    let domains;
+    let services;
+    /**
+     * Describe the current services, and build up a proxy api based on that.
+     *
+     * This API matches the api at the time the this function is run, which may be different from any generated typescript definitions from the past.
+     */
+    lifecycle.onBootstrap(async () => {
+        if (!config.hass.AUTO_SCAN_CALL_PROXY) {
+            logger.debug(`skip service populate`);
+            return;
+        }
+        logger.debug(`runtime populate service interfaces`);
+        await loadServiceList();
+    });
+    function getDomain(domain) {
+        if (!domains || !domains?.includes(domain)) {
+            if (!NOT_A_DOMAIN.has(domain)) {
+                logger.error({ domain }, `unknown domain`);
+            }
+            return undefined;
+        }
+        const domainItem = services.find(i => i.domain === domain);
+        if (!domainItem) {
+            throw new __1.InternalError(context, "HALLUCINATED_DOMAIN", `Cannot access call_service#${domain}. Home Assistant doesn't list it as a real domain.`);
+        }
+        return Object.fromEntries(Object.entries(domainItem.services).map(([key]) => [
+            key,
+            async (parameters) => await sendMessage(`${domain}.${key}`, {
+                ...parameters,
+            }),
+        ]));
+    }
+    async function loadServiceList(recursion = __1.START) {
+        logger.info(`fetching service list`);
+        services = await hass.fetch.listServices();
+        if (__1.is.empty(services)) {
+            if (recursion > MAX_ATTEMPTS) {
+                logger.fatal(`Failed to load service list from Home Assistant. Validate configuration`);
+                (0, process_1.exit)(FAILED);
+            }
+            logger.warn("failed to retrieve {service} list. Retrying {%s}/[%s]", recursion, MAX_ATTEMPTS);
+            await (0, __1.sleep)(FAILED_LOAD_DELAY * __1.SECOND);
+            await loadServiceList(recursion + __1.INCREMENT);
+            return;
+        }
+        domains = services.map(i => i.domain);
+        services.forEach(value => {
+            logger.trace({ services: Object.keys(value.services) }, `loaded domain [%s]`, value.domain);
+        });
+    }
+    /**
+     * Prefer sending via socket, if available.
+     */
+    async function sendMessage(serviceName, service_data) {
+        if (!hass.socket.getConnectionActive()) {
+            return await hass.fetch.callService(serviceName, service_data);
+        }
+        const [domain, service] = serviceName.split(".");
+        // User can just not await this call if they don't care about the "waitForChange"
+        return await hass.socket.sendMessage({
+            domain,
+            service,
+            service_data,
+            type: __2.HASSIO_WS_COMMAND.call_service,
+        }, true);
+    }
+    function buildCallProxy() {
+        return new Proxy({}, {
+            get: (_, domain) => getDomain(domain),
+        });
+    }
+    return buildCallProxy();
+}
+exports.CallProxy = CallProxy;
+exports.default = CallProxy;
+//# sourceMappingURL=call-proxy.extension.js.map

package/dist/hass/extensions/call-proxy.extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-proxy.extension.js","sourceRoot":"","sources":["../../../src/hass/extensions/call-proxy.extension.ts"],"names":[],"mappings":"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"}

package/dist/hass/extensions/entity-manager.extension.d.ts

@@ -0,0 +1,61 @@
+import { TBlackHole, TServiceParams } from "../..";
+import { ENTITY_STATE, EntityHistoryDTO, EntityHistoryResult, PICK_ENTITY } from "..";
+export declare const ENTITY_UPDATE_RECEIVER: unique symbol;
+export type ByIdProxy<ENTITY_ID extends PICK_ENTITY> = ENTITY_STATE<ENTITY_ID> & {
+    entity_id: ENTITY_ID;
+    /**
+     * Run callback
+     */
+    onUpdate: (callback: (state: NonNullable<ENTITY_STATE<ENTITY_ID>>) => TBlackHole) => void;
+    /**
+     * Run callback once, for next update
+     */
+    once: (callback: (state: NonNullable<ENTITY_STATE<ENTITY_ID>>) => TBlackHole) => void;
+    /**
+     * Will resolve with the next state of the next value. No time limit
+     */
+    nextState: () => Promise<ENTITY_STATE<ENTITY_ID>>;
+};
+export declare function EntityManager({ logger, hass, lifecycle }: TServiceParams): {
+    /**
+     * Internal library use only
+     */
+    [ENTITY_UPDATE_RECEIVER]: <ENTITY extends PICK_ENTITY = PICK_ENTITY>(entity_id: PICK_ENTITY, new_state: ENTITY_STATE<ENTITY>, old_state: ENTITY_STATE<ENTITY>) => void;
+    /**
+     * Retrieves a proxy object for a specified entity. This proxy object
+     * provides current values and event hooks for the entity.
+     */
+    byId: <ENTITY_ID extends PICK_ENTITY>(entity_id: ENTITY_ID) => ByIdProxy<ENTITY_ID>;
+    /**
+     * Lists all entities within a specified domain. This is useful for
+     * domain-specific operations or queries.
+     */
+    findByDomain: <DOMAIN extends "binary_sensor" | "button" | "scene" | "sensor" | "switch" | "calendar" | "light">(domain: DOMAIN) => ByIdProxy<PICK_ENTITY>[];
+    /**
+     * Retrieves the current state of a given entity. This method returns
+     * raw data, offering a direct view of the entity's state at a given moment.
+     */
+    getCurrentState: <ENTITY_ID_1 extends PICK_ENTITY>(entity_id: ENTITY_ID_1) => NonNullable<ENTITY_STATE<ENTITY_ID_1>>;
+    /**
+     * Retrieves the historical state data of entities over a specified time
+     * period. Useful for analysis or tracking changes over time.
+     */
+    history: <ENTITES extends PICK_ENTITY[]>(payload: Omit<EntityHistoryDTO<ENTITES>, "type">) => Promise<{
+        [k: string]: EntityHistoryResult[];
+    }>;
+    /**
+     * Provides a simple listing of all entity IDs. Useful for enumeration
+     * and quick reference to all available entities.
+     */
+    listEntities: () => PICK_ENTITY[];
+    /**
+     * Initiates a refresh of the current entity states. Useful for ensuring
+     * synchronization with the latest state data from Home Assistant.
+     */
+    refresh: (recursion?: number) => Promise<void>;
+};
+declare module "../../utilities" {
+    interface IsIt {
+        entity(entity: PICK_ENTITY): entity is PICK_ENTITY;
+    }
+}

package/dist/hass/extensions/entity-manager.extension.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityManager = exports.ENTITY_UPDATE_RECEIVER = void 0;
+const tslib_1 = require("tslib");
+const async_1 = require("async");
+const dayjs_1 = tslib_1.__importDefault(require("dayjs"));
+const node_cache_1 = require("node-cache");
+const object_path_1 = require("object-path");
+const __1 = require("../..");
+const __2 = require("..");
+exports.ENTITY_UPDATE_RECEIVER = Symbol.for("entityUpdateReceiver");
+const MAX_ATTEMPTS = 50;
+const FAILED_LOAD_DELAY = 5;
+const UNLIMITED = 0;
+const RECENT = 5;
+const BOTTLENECK_UPDATES = 20;
+function EntityManager({ logger, hass, lifecycle }) {
+    // # Local vars
+    /**
+     * MASTER_STATE.switch.desk_light = {entity_id,state,attributes,...}
+     */
+    let MASTER_STATE = {};
+    const ENTITY_PROXIES = new Map();
+    let lastRefresh;
+    // * Local event emitter for coordination of socket events
+    // Other libraries will internally take advantage of this eventemitter
+    const event = new node_cache_1.EventEmitter();
+    event.setMaxListeners(UNLIMITED);
+    let init = false;
+    // # Methods
+    // ## Retrieve raw state object for entity
+    function getCurrentState(entity_id) {
+        return (0, object_path_1.get)(MASTER_STATE, entity_id);
+    }
+    // ## Proxy version of the logic
+    function proxyGetLogic(entity, property) {
+        if (!init) {
+            return undefined;
+        }
+        const valid = ["state", "attributes", "last"].some(i => property.startsWith(i));
+        if (!valid) {
+            logger.error({ entity, property }, `invalid property lookup`);
+            return undefined;
+        }
+        const current = getCurrentState(entity);
+        const defaultValue = (property === "state" ? undefined : {});
+        if (!current) {
+            logger.error({ defaultValue, name: entity, property }, `proxyGetLogic cannot find entity`);
+        }
+        return (0, object_path_1.get)(current, property, defaultValue);
+    }
+    // ## Retrieve a proxy by id
+    function byId(entity_id) {
+        if (!ENTITY_PROXIES.has(entity_id)) {
+            ENTITY_PROXIES.set(entity_id, new Proxy({ entity_id }, {
+                // things that shouldn't be needed: this extract
+                get: (_, property) => {
+                    if (property === "onUpdate") {
+                        return (callback) => event.on(entity_id, async (a, b) => callback(a, b));
+                    }
+                    if (property === "once") {
+                        return (callback) => event.once(entity_id, async (a, b) => callback(a, b));
+                    }
+                    if (property === "entity_id") {
+                        return entity_id;
+                    }
+                    if (property === "nextState") {
+                        return new Promise(done => {
+                            event.once(entity_id, (entity) => done(entity));
+                        });
+                    }
+                    return proxyGetLogic(entity_id, property);
+                },
+            }));
+        }
+        return ENTITY_PROXIES.get(entity_id);
+    }
+    // ## Retrieve entity history (via socket)
+    async function history(payload) {
+        logger.trace({ payload }, `looking up entity history`);
+        const result = (await hass.socket.sendMessage({
+            ...payload,
+            end_time: (0, dayjs_1.default)(payload.end_time).toISOString(),
+            start_time: (0, dayjs_1.default)(payload.start_time).toISOString(),
+            type: __2.HASSIO_WS_COMMAND.history_during_period,
+        }));
+        const entities = Object.keys(result);
+        return Object.fromEntries(entities.map((entity_id) => {
+            const key = entity_id;
+            const states = result[entity_id];
+            const value = states.map(data => {
+                return {
+                    attributes: data.a,
+                    date: new Date(data.lu * __1.SECOND),
+                    state: data.s,
+                };
+            });
+            return [key, value];
+        }));
+    }
+    // ## Build a string array of all known entity ids
+    function listEntities() {
+        return Object.keys(MASTER_STATE).flatMap(domain => Object.keys(MASTER_STATE[domain]).map(id => `${domain}.${id}`));
+    }
+    // ## Gather all entity proxies for a domain
+    function findByDomain(domain) {
+        return Object.keys(MASTER_STATE[domain] ?? {}).map(i => byId(`${domain}.${i}`));
+    }
+    // ## Load all entity state information from hass
+    async function refresh(recursion = __1.START) {
+        const now = (0, dayjs_1.default)();
+        if (lastRefresh) {
+            const diff = lastRefresh.diff(now, "ms");
+            if (diff >= RECENT * __1.SECOND) {
+                logger.warn({ diff }, `multiple refreshes in close time`);
+            }
+        }
+        lastRefresh = now;
+        // - Fetch list of entities
+        const states = await hass.fetch.getAllEntities();
+        // - Keep retrying until max failures reached
+        if (__1.is.empty(states)) {
+            if (recursion > MAX_ATTEMPTS) {
+                logger.fatal(`failed to load service list from Home Assistant. Validate configuration`);
+                __1.ZCC_Testing.FailFast();
+            }
+            logger.warn("failed to retrieve entity list. Retrying {%s}/[%s]", recursion, MAX_ATTEMPTS);
+            await (0, __1.sleep)(FAILED_LOAD_DELAY * __1.SECOND);
+            await refresh(recursion + __1.INCREMENT);
+            return;
+        }
+        // - Preserve old state for comparison
+        const oldState = MASTER_STATE;
+        MASTER_STATE = {};
+        const emitUpdates = [];
+        // - Go through all entities, setting the state
+        // ~ If this is a refresh (not an initial boot), track what changed so events can be emitted
+        states.forEach(entity => {
+            // ? Set first, ensure data is populated
+            // `nextTick` will fire AFTER loop finishes
+            (0, object_path_1.set)(MASTER_STATE, entity.entity_id, entity, (0, object_path_1.get)(oldState, entity.entity_id));
+            if (!init) {
+                return;
+            }
+            const old = (0, object_path_1.get)(oldState, entity.entity_id);
+            if (__1.is.equal(old, entity)) {
+                logger.trace({ name: entity.entity_id }, `no change on refresh`);
+                return;
+            }
+            emitUpdates.push(entity);
+        });
+        // Attempt to not blow up the system?
+        // TODO: does this gain anything? is a debounce needed somewhere else instead?
+        setImmediate(async () => {
+            await (0, async_1.eachLimit)(emitUpdates, BOTTLENECK_UPDATES, async (entity) => await EntityUpdateReceiver(entity.entity_id, entity, (0, object_path_1.get)(oldState, entity.entity_id)));
+        });
+        init = true;
+    }
+    // ## is.entity definition
+    // Actually tie the type casting to real state
+    __1.is.entity = (entityId) => __1.is.undefined((0, object_path_1.get)(MASTER_STATE, entityId));
+    // ## Receiver function for incoming entity updates
+    function EntityUpdateReceiver(entity_id, new_state, old_state) {
+        if (new_state === null) {
+            logger.warn({ name: entity_id }, `removing deleted entity from {MASTER_STATE}`);
+            (0, object_path_1.del)(MASTER_STATE, entity_id);
+            return;
+        }
+        (0, object_path_1.set)(MASTER_STATE, entity_id, new_state);
+        event.emit(entity_id, new_state, old_state);
+    }
+    lifecycle.onPostConfig(async () => {
+        logger.debug(`pre populate {MASTER_STATE}`);
+        await refresh();
+    });
+    return {
+        /**
+         * Internal library use only
+         */
+        [exports.ENTITY_UPDATE_RECEIVER]: EntityUpdateReceiver,
+        /**
+         * Retrieves a proxy object for a specified entity. This proxy object
+         * provides current values and event hooks for the entity.
+         */
+        byId,
+        /**
+         * Lists all entities within a specified domain. This is useful for
+         * domain-specific operations or queries.
+         */
+        findByDomain,
+        /**
+         * Retrieves the current state of a given entity. This method returns
+         * raw data, offering a direct view of the entity's state at a given moment.
+         */
+        getCurrentState,
+        /**
+         * Retrieves the historical state data of entities over a specified time
+         * period. Useful for analysis or tracking changes over time.
+         */
+        history,
+        /**
+         * Provides a simple listing of all entity IDs. Useful for enumeration
+         * and quick reference to all available entities.
+         */
+        listEntities,
+        /**
+         * Initiates a refresh of the current entity states. Useful for ensuring
+         * synchronization with the latest state data from Home Assistant.
+         */
+        refresh,
+    };
+}
+exports.EntityManager = EntityManager;
+//# sourceMappingURL=entity-manager.extension.js.map

package/dist/hass/extensions/entity-manager.extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-manager.extension.js","sourceRoot":"","sources":["../../../src/hass/extensions/entity-manager.extension.ts"],"names":[],"mappings":"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"}

package/dist/hass/extensions/fetch-api.extension.d.ts

@@ -0,0 +1,26 @@
+import { FilteredFetchArguments, TFetch, TServiceParams } from "../..";
+import { CalendarEvent, CalendarFetchOptions, CheckConfigResult, ENTITY_STATE, HassConfig, HassServiceDTO, HomeAssistantServerLogItem, PICK_ENTITY, PICK_SERVICE, PICK_SERVICE_PARAMETERS } from "..";
+type SendBody<STATE extends string | number = string, ATTRIBUTES extends object = object> = {
+    attributes?: ATTRIBUTES;
+    state?: STATE;
+};
+export declare function FetchAPI({ logger, lifecycle, context, config, }: TServiceParams): {
+    calendarSearch: ({ calendar, start, end, }: CalendarFetchOptions) => Promise<CalendarEvent[]>;
+    callService: <SERVICE extends PICK_SERVICE>(serviceName: SERVICE, data: PICK_SERVICE_PARAMETERS<SERVICE>) => Promise<ENTITY_STATE<PICK_ENTITY>[]>;
+    checkConfig: () => Promise<CheckConfigResult>;
+    download: (destination: string, fetchWith: FilteredFetchArguments) => Promise<void>;
+    fetch: TFetch;
+    fetchEntityCustomizations: <T extends Record<never, unknown> = Record<"local" | "global", Record<string, string>>>(entityId: string | string[]) => Promise<T>;
+    fetchEntityHistory: <ENTITY extends PICK_ENTITY = PICK_ENTITY, T_1 extends ENTITY_STATE<ENTITY> = ENTITY_STATE<ENTITY>>(entity_id: ENTITY, from: Date, to: Date, extra?: {
+        minimal_response?: "";
+    }) => Promise<T_1[]>;
+    fireEvent: <DATA extends object = object>(event: string, data?: DATA) => Promise<void>;
+    getAllEntities: () => Promise<ENTITY_STATE<PICK_ENTITY>[]>;
+    getConfig: () => Promise<HassConfig>;
+    getLogs: () => Promise<HomeAssistantServerLogItem[]>;
+    getRawLogs: () => Promise<string>;
+    listServices: () => Promise<HassServiceDTO[]>;
+    updateEntity: <STATE extends string | number = string, ATTRIBUTES extends object = object>(entity_id: PICK_ENTITY, { attributes, state }: SendBody<STATE, ATTRIBUTES>) => Promise<void>;
+    webhook: (name: string, data?: object) => Promise<void>;
+};
+export {};