@digital-alchemy/hass 25.8.12-beta.0 → 25.10.18

package/src/services/area.service.mts

@@ -1,15 +1,9 @@
-import { debounce, eachSeries, InternalError, TServiceParams } from "@digital-alchemy/core";
+import type { TServiceParams } from "@digital-alchemy/core";
+import { debounce, eachSeries, InternalError } from "@digital-alchemy/core";
 
-import {
-  AREA_REGISTRY_UPDATED,
-  AreaCreate,
-  AreaDetails,
-  EARLY_ON_READY,
-  ENTITY_REGISTRY_UPDATED,
-  HassAreaService,
-  perf,
-} from "../index.mts";
-import { ANY_ENTITY, TAreaId } from "../user.mts";
+import type { AreaCreate, AreaDetails, HassAreaService } from "../index.mts";
+import { AREA_REGISTRY_UPDATED, EARLY_ON_READY, ENTITY_REGISTRY_UPDATED, perf } from "../index.mts";
+import type { ANY_ENTITY, TAreaId } from "../user.mts";
 
 export function Area({
   hass,

package/src/services/backup.service.mts

@@ -1,6 +1,7 @@
-import { SECOND, sleep, TServiceParams } from "@digital-alchemy/core";
+import type { TServiceParams } from "@digital-alchemy/core";
+import { SECOND, sleep } from "@digital-alchemy/core";
 
-import {
+import type {
   BackupResponse,
   HassBackupService,
   HomeAssistantBackup,

package/src/services/call-proxy.service.mts

@@ -1,12 +1,12 @@
-import { TServiceParams } from "@digital-alchemy/core";
+import type { TServiceParams } from "@digital-alchemy/core";
 
-import {
+import type {
   ALL_SERVICE_DOMAINS,
-  perf,
   PICK_SERVICE,
   PICK_SERVICE_PARAMETERS,
 } from "../helpers/index.mts";
-import { iCallService } from "../user.mts";
+import { perf } from "../helpers/index.mts";
+import type { iCallService } from "../user.mts";
 
 export function CallProxy({
   logger,

package/src/services/config.service.mts

@@ -1,14 +1,11 @@
 /* eslint-disable @typescript-eslint/no-magic-numbers */
-import { asyncNoop, INCREMENT, SECOND, sleep, START, TServiceParams } from "@digital-alchemy/core";
+import type { TServiceParams } from "@digital-alchemy/core";
+import { asyncNoop, INCREMENT, SECOND, sleep, START } from "@digital-alchemy/core";
 import { env } from "process";
 
-import {
-  ALL_SERVICE_DOMAINS,
-  HassConfigService,
-  HassServiceDTO,
-  PostConfigPriorities,
-} from "../helpers/index.mts";
-import { iCallService } from "../user.mts";
+import type { ALL_SERVICE_DOMAINS, HassConfigService, HassServiceDTO } from "../helpers/index.mts";
+import { PostConfigPriorities } from "../helpers/index.mts";
+import type { iCallService } from "../user.mts";
 
 const MAX_ATTEMPTS = 50;
 const FAILED = 1;

package/src/services/conversation.service.mts

@@ -1,11 +1,7 @@
-import { TServiceParams } from "@digital-alchemy/core";
+import type { TServiceParams } from "@digital-alchemy/core";
 
-import {
-  EditAliasOptions,
-  HassConversationService,
-  ToggleExpose,
-  UPDATE_REGISTRY,
-} from "../helpers/index.mts";
+import type { EditAliasOptions, HassConversationService, ToggleExpose } from "../helpers/index.mts";
+import { UPDATE_REGISTRY } from "../helpers/index.mts";
 
 export function Conversation({ hass, logger }: TServiceParams): HassConversationService {
   async function addAlias({ entity, alias }: EditAliasOptions) {

package/src/services/device.service.mts

@@ -1,12 +1,8 @@
-import { debounce, TServiceParams } from "@digital-alchemy/core";
+import type { TServiceParams } from "@digital-alchemy/core";
+import { debounce } from "@digital-alchemy/core";
 
-import {
-  DEVICE_REGISTRY_UPDATED,
-  DeviceDetails,
-  EARLY_ON_READY,
-  HassDeviceService,
-  perf,
-} from "../helpers/index.mts";
+import type { DeviceDetails, HassDeviceService } from "../helpers/index.mts";
+import { DEVICE_REGISTRY_UPDATED, EARLY_ON_READY, perf } from "../helpers/index.mts";
 
 export function Device({
   hass,

package/src/services/diagnostics.service.mts

@@ -1,4 +1,4 @@
-import { TServiceParams } from "@digital-alchemy/core";
+import type { TServiceParams } from "@digital-alchemy/core";
 import { channel } from "diagnostics_channel";
 
 function createDiagnostics<CHANNEL extends string>(context: string, channels: CHANNEL[]) {

package/src/services/entity.service.mts

@@ -1,28 +1,20 @@
-import {
-  debounce,
-  each,
-  eachSeries,
-  INCREMENT,
-  SECOND,
-  sleep,
-  START,
-  TServiceParams,
-} from "@digital-alchemy/core";
-import dayjs, { Dayjs } from "dayjs";
+import type { TServiceParams } from "@digital-alchemy/core";
+import { debounce, each, eachSeries, INCREMENT, SECOND, sleep, START } from "@digital-alchemy/core";
+import type { Dayjs } from "dayjs";
+import dayjs from "dayjs";
 
-import {
+import type {
   EditLabelOptions,
-  ENTITY_REGISTRY_UPDATED,
   ENTITY_STATE,
   EntityHistoryDTO,
   EntityHistoryItem,
   EntityHistoryResult,
   EntityRegistryItem,
   HassEntityManager,
-  perf,
   TMasterState,
 } from "../index.mts";
-import { ALL_DOMAINS, ANY_ENTITY, PICK_ENTITY } from "../user.mts";
+import { ENTITY_REGISTRY_UPDATED, perf } from "../index.mts";
+import type { ALL_DOMAINS, ANY_ENTITY, PICK_ENTITY } from "../user.mts";
 
 const MAX_ATTEMPTS = 10;
 const RECENT = 5;

package/src/services/events.service.mts

@@ -1,13 +1,12 @@
-import { TServiceParams } from "@digital-alchemy/core";
+import type { TServiceParams } from "@digital-alchemy/core";
 
+import type { HassEventsService, SimpleCallback } from "../helpers/index.mts";
 import {
   AREA_REGISTRY_UPDATED,
   DEVICE_REGISTRY_UPDATED,
   ENTITY_REGISTRY_UPDATED,
   FLOOR_REGISTRY_UPDATED,
-  HassEventsService,
   LABEL_REGISTRY_UPDATED,
-  SimpleCallback,
   ZONE_REGISTRY_UPDATED,
 } from "../helpers/index.mts";
 

package/src/services/fetch-api.service.mts

@@ -1,8 +1,10 @@
-import { DOWN, NO_CHANGE, SECOND, TServiceParams, UP } from "@digital-alchemy/core";
-import dayjs, { Dayjs } from "dayjs";
+import type { TServiceParams } from "@digital-alchemy/core";
+import { DOWN, NO_CHANGE, SECOND, UP } from "@digital-alchemy/core";
+import type { Dayjs } from "dayjs";
+import dayjs from "dayjs";
 
-import { FetchArguments, FilteredFetchArguments, TFetchBody } from "../helpers/fetch.mts";
-import {
+import type { FetchArguments, FilteredFetchArguments, TFetchBody } from "../helpers/fetch.mts";
+import type {
   ALL_SERVICE_DOMAINS,
   CalendarEvent,
   CalendarFetchOptions,
@@ -11,13 +13,12 @@ import {
   HassConfig,
   HassServiceDTO,
   HomeAssistantServerLogItem,
-  perf,
   PICK_SERVICE,
   PICK_SERVICE_PARAMETERS,
-  PostConfigPriorities,
   RawCalendarEvent,
 } from "../helpers/index.mts";
-import { ANY_ENTITY } from "../user.mts";
+import { perf, PostConfigPriorities } from "../helpers/index.mts";
+import type { ANY_ENTITY } from "../user.mts";
 
 type SendBody<STATE extends string | number = string, ATTRIBUTES extends object = object> = {
   attributes?: ATTRIBUTES;

package/src/services/floor.service.mts

@@ -1,14 +1,9 @@
-import { debounce, TServiceParams } from "@digital-alchemy/core";
+import type { TServiceParams } from "@digital-alchemy/core";
+import { debounce } from "@digital-alchemy/core";
 
-import {
-  EARLY_ON_READY,
-  FLOOR_REGISTRY_UPDATED,
-  FloorCreate,
-  FloorDetails,
-  HassFloorService,
-  perf,
-} from "../helpers/index.mts";
-import { TFloorId } from "../user.mts";
+import type { FloorCreate, FloorDetails, HassFloorService } from "../helpers/index.mts";
+import { EARLY_ON_READY, FLOOR_REGISTRY_UPDATED, perf } from "../helpers/index.mts";
+import type { TFloorId } from "../user.mts";
 
 export function Floor({
   hass,

package/src/services/id-by.service.mts

@@ -1,7 +1,9 @@
-import { FIRST, SINGLE, TServiceParams } from "@digital-alchemy/core";
+import type { TServiceParams } from "@digital-alchemy/core";
+import { FIRST, SINGLE } from "@digital-alchemy/core";
 
-import { domain, EntityRegistryItem, IDByInterface } from "../index.mts";
-import {
+import type { EntityRegistryItem, IDByInterface } from "../index.mts";
+import { domain } from "../index.mts";
+import type {
   ALL_DOMAINS,
   ANY_ENTITY,
   HassUniqueIdMapping,

package/src/services/internal.service.mts

@@ -1,19 +1,19 @@
-import { FIRST, InternalError, TServiceParams } from "@digital-alchemy/core";
+import type { TServiceParams } from "@digital-alchemy/core";
+import { FIRST, InternalError } from "@digital-alchemy/core";
 import { createWriteStream } from "fs";
 import { pipeline } from "stream";
 import { promisify } from "util";
 
-import {
-  buildFilterString,
+import type {
   DownloadOptions,
   FetchArguments,
   FetcherOptions,
   FetchProcessTypes,
   FetchWith,
-  isDomain,
   MaybeHttpError,
   TFetchBody,
 } from "../helpers/index.mts";
+import { buildFilterString, isDomain } from "../helpers/index.mts";
 
 const streamPipeline = promisify(pipeline);
 

package/src/services/label.service.mts

@@ -1,14 +1,9 @@
-import { debounce, TServiceParams } from "@digital-alchemy/core";
+import type { TServiceParams } from "@digital-alchemy/core";
+import { debounce } from "@digital-alchemy/core";
 
-import {
-  EARLY_ON_READY,
-  HassLabelService,
-  LABEL_REGISTRY_UPDATED,
-  LabelDefinition,
-  LabelOptions,
-  perf,
-} from "../helpers/index.mts";
-import { TLabelId } from "../user.mts";
+import type { HassLabelService, LabelDefinition, LabelOptions } from "../helpers/index.mts";
+import { EARLY_ON_READY, LABEL_REGISTRY_UPDATED, perf } from "../helpers/index.mts";
+import type { TLabelId } from "../user.mts";
 
 export function Label({
   hass,

package/src/services/reference.service.mts

@@ -1,17 +1,18 @@
-import { DOWN, NONE, sleep, TAnyFunction, TServiceParams, UP } from "@digital-alchemy/core";
-import dayjs, { Dayjs } from "dayjs";
-import { Get } from "type-fest";
+import type { TAnyFunction, TServiceParams } from "@digital-alchemy/core";
+import { DOWN, NONE, sleep, UP } from "@digital-alchemy/core";
+import type { Dayjs } from "dayjs";
+import dayjs from "dayjs";
+import type { Get } from "type-fest";
 
-import {
+import type {
   ALL_SERVICE_DOMAINS,
   ByIdProxy,
-  domain,
   ENTITY_STATE,
   HassReferenceService,
-  perf,
   RemoveCallback,
 } from "../helpers/index.mts";
-import {
+import { domain, perf } from "../helpers/index.mts";
+import type {
   ANY_ENTITY,
   HassUniqueIdMapping,
   PICK_ENTITY,

package/src/services/registry.service.mts

@@ -1,6 +1,6 @@
-import { TServiceParams } from "@digital-alchemy/core";
+import type { TServiceParams } from "@digital-alchemy/core";
 
-import {
+import type {
   ConfigEntry,
   HassConfig,
   HassRegistryService,

package/src/services/websocket-api.service.mts

@@ -1,16 +1,12 @@
-import {
-  InternalError,
-  SECOND,
-  sleep,
-  START,
-  TBlackHole,
-  TServiceParams,
-} from "@digital-alchemy/core";
-import dayjs, { Dayjs } from "dayjs";
+import type { TBlackHole, TServiceParams } from "@digital-alchemy/core";
+import { InternalError, SECOND, sleep, START } from "@digital-alchemy/core";
+import type { Dayjs } from "dayjs";
+import dayjs from "dayjs";
 import EventEmitter from "events";
+import type { EmptyObject } from "type-fest";
 import WS from "ws";
 
-import {
+import type {
   ConnectionState,
   EntityUpdateEvent,
   HassWebsocketAPI,
@@ -523,11 +519,10 @@ export function WebsocketAPI({
   }
 
   // #MARK: subscribe
-  async function subscribe<EVENT extends string>({
-    event_type,
-    context,
-    exec,
-  }: SocketSubscribeOptions<EVENT>) {
+  async function subscribe<
+    EVENT extends string,
+    PAYLOAD extends Record<string, unknown> = EmptyObject,
+  >({ event_type, context, exec }: SocketSubscribeOptions<EVENT, PAYLOAD>) {
     await hass.socket.sendMessage({ event_type, type: "subscribe_events" });
     return hass.socket.onEvent({
       context,

package/src/services/zone.service.mts

@@ -1,14 +1,8 @@
-import { debounce, TServiceParams } from "@digital-alchemy/core";
+import type { TServiceParams } from "@digital-alchemy/core";
+import { debounce } from "@digital-alchemy/core";
 
-import {
-  EARLY_ON_READY,
-  HassZoneService,
-  ManifestItem,
-  perf,
-  ZONE_REGISTRY_UPDATED,
-  ZoneDetails,
-  ZoneOptions,
-} from "../helpers/index.mts";
+import type { HassZoneService, ManifestItem, ZoneDetails, ZoneOptions } from "../helpers/index.mts";
+import { EARLY_ON_READY, perf, ZONE_REGISTRY_UPDATED } from "../helpers/index.mts";
 
 export function Zone({
   config,

package/src/testing/area.spec.mts

@@ -1,9 +1,10 @@
 import { sleep } from "@digital-alchemy/core";
 import { subscribe } from "diagnostics_channel";
 
-import { AREA_REGISTRY_UPDATED, AreaDetails } from "../helpers/index.mts";
+import type { AreaDetails } from "../helpers/index.mts";
+import { AREA_REGISTRY_UPDATED } from "../helpers/index.mts";
 import { hassTestRunner, INTERNAL_MESSAGE } from "../mock_assistant/index.mts";
-import { TAreaId } from "../user.mts";
+import type { TAreaId } from "../user.mts";
 
 const EXAMPLE_AREA = {
   area_id: "empty_area" as TAreaId,

package/src/testing/backup.spec.mts

@@ -1,6 +1,6 @@
 import { SINGLE } from "@digital-alchemy/core";
 
-import { BackupResponse } from "../helpers/index.mts";
+import type { BackupResponse } from "../helpers/index.mts";
 import { hassTestRunner } from "../mock_assistant/index.mts";
 
 describe("Backup", () => {

package/src/testing/config.spec.mts

@@ -1,5 +1,5 @@
 import { env } from "process";
-import { MockInstance } from "vitest";
+import type { MockInstance } from "vitest";
 
 import { hassTestRunner } from "../mock_assistant/index.mts";
 

package/src/testing/device.spec.mts

@@ -2,7 +2,7 @@ import { subscribe } from "node:diagnostics_channel";
 
 import { sleep } from "@digital-alchemy/core";
 
-import { DeviceDetails } from "../helpers/index.mts";
+import type { DeviceDetails } from "../helpers/index.mts";
 import { hassTestRunner } from "../mock_assistant/index.mts";
 
 describe("Device", () => {

package/src/testing/entity.spec.mts

@@ -3,9 +3,9 @@ import { subscribe } from "node:diagnostics_channel";
 import { sleep } from "@digital-alchemy/core";
 import dayjs from "dayjs";
 
-import { ENTITY_STATE } from "../index.mts";
+import type { ENTITY_STATE } from "../index.mts";
 import { hassTestRunner } from "../mock_assistant/index.mts";
-import { ANY_ENTITY } from "../user.mts";
+import type { ANY_ENTITY } from "../user.mts";
 
 describe("Entity", () => {
   afterEach(async () => {

package/src/testing/fetch-api.spec.mts

@@ -1,7 +1,7 @@
 import dayjs from "dayjs";
-import { MockInstance } from "vitest";
+import type { MockInstance } from "vitest";
 
-import { HassConfig } from "../helpers/index.mts";
+import type { HassConfig } from "../helpers/index.mts";
 import { hassTestRunner } from "../mock_assistant/index.mts";
 
 describe("FetchAPI", () => {

package/src/testing/floor.spec.mts

@@ -2,9 +2,10 @@ import { subscribe } from "node:diagnostics_channel";
 
 import { sleep } from "@digital-alchemy/core";
 
-import { FLOOR_REGISTRY_UPDATED, FloorDetails } from "../helpers/index.mts";
+import type { FloorDetails } from "../helpers/index.mts";
+import { FLOOR_REGISTRY_UPDATED } from "../helpers/index.mts";
 import { hassTestRunner } from "../mock_assistant/index.mts";
-import { TFloorId } from "../user.mts";
+import type { TFloorId } from "../user.mts";
 
 describe("Floor", () => {
   const EXAMPLE_FLOOR = {

package/src/testing/id-by.spec.mts

@@ -1,5 +1,5 @@
 import { hassTestRunner } from "../mock_assistant/index.mts";
-import { PICK_ENTITY } from "../user.mts";
+import type { PICK_ENTITY } from "../user.mts";
 
 afterEach(async () => {
   await hassTestRunner.teardown();

package/src/testing/label.spec.mts

@@ -2,9 +2,10 @@ import { subscribe } from "node:diagnostics_channel";
 
 import { sleep } from "@digital-alchemy/core";
 
-import { LABEL_REGISTRY_UPDATED, LabelDefinition } from "../helpers/index.mts";
+import type { LabelDefinition } from "../helpers/index.mts";
+import { LABEL_REGISTRY_UPDATED } from "../helpers/index.mts";
 import { hassTestRunner } from "../mock_assistant/index.mts";
-import { TLabelId } from "../user.mts";
+import type { TLabelId } from "../user.mts";
 
 describe("Label", () => {
   const EXAMPLE_LABEL = {

package/src/testing/ref-by.spec.mts

@@ -1,8 +1,8 @@
 import dayjs from "dayjs";
 
-import { ENTITY_STATE } from "../helpers/index.mts";
+import type { ENTITY_STATE } from "../helpers/index.mts";
 import { hassTestRunner } from "../mock_assistant/index.mts";
-import { ANY_ENTITY } from "../user.mts";
+import type { ANY_ENTITY } from "../user.mts";
 
 describe("References", () => {
   afterEach(async () => {

package/src/testing/zone.spec.mts

@@ -2,7 +2,8 @@ import { subscribe } from "node:diagnostics_channel";
 
 import { sleep } from "@digital-alchemy/core";
 
-import { ZONE_REGISTRY_UPDATED, ZoneDetails } from "../helpers/index.mts";
+import type { ZoneDetails } from "../helpers/index.mts";
+import { ZONE_REGISTRY_UPDATED } from "../helpers/index.mts";
 import { hassTestRunner } from "../mock_assistant/index.mts";
 
 describe("Zone", () => {