@shepherdjerred/home-assistant 0.1.0-dev.14474

package/dist/rest/client.js

@@ -0,0 +1,112 @@
+import { z } from "zod";
+import { normalizeBaseUrl } from "../shared/config.js";
+import { HaApiError, HaAuthError, HaNotFoundError } from "./errors.js";
+import { EntityState, ConfigEntryDiagnostics, FireEventResponse, HaConfig, HistoryResponse, ServiceCallResult, } from "./schemas.js";
+const RawJson = z.unknown();
+export class HomeAssistantRestClient {
+    baseUrl;
+    token;
+    constructor(config) {
+        this.baseUrl = normalizeBaseUrl(config.baseUrl);
+        this.token = config.token;
+    }
+    async getConfig() {
+        const body = await this.request("GET", "/api/config");
+        return HaConfig.parse(body);
+    }
+    async getStates() {
+        const body = await this.request("GET", "/api/states");
+        return z.array(EntityState).parse(body);
+    }
+    async getState(entityId) {
+        const schema = EntityState.extend({ entity_id: z.literal(entityId) });
+        const body = await this.request("GET", `/api/states/${encodeURIComponent(entityId)}`, { notFoundResource: entityId });
+        return schema.parse(body);
+    }
+    async callService(domain, service, data, options) {
+        const path = this.buildServicePath(domain, service, options);
+        const body = await this.request("POST", path, {
+            body: data ?? {},
+        });
+        return ServiceCallResult.parse(body);
+    }
+    async fireEvent(eventType, data) {
+        const body = await this.request("POST", `/api/events/${encodeURIComponent(eventType)}`, { body: data ?? {} });
+        return FireEventResponse.parse(body);
+    }
+    async renderTemplate(template) {
+        const response = await this.rawRequest("POST", "/api/template", {
+            template,
+        });
+        await this.assertOk(response, "POST", "/api/template");
+        return response.text();
+    }
+    async getHistory(entityIds, options = {}) {
+        const start = options.start ?? new Date(Date.now() - 24 * 60 * 60 * 1000);
+        const params = new URLSearchParams();
+        params.set("filter_entity_id", entityIds.join(","));
+        if (options.end !== undefined) {
+            params.set("end_time", options.end.toISOString());
+        }
+        if (options.minimalResponse === true) {
+            params.set("minimal_response", "true");
+        }
+        if (options.noAttributes === true) {
+            params.set("no_attributes", "true");
+        }
+        if (options.significantChangesOnly === true) {
+            params.set("significant_changes_only", "true");
+        }
+        const path = `/api/history/period/${start.toISOString()}?${params.toString()}`;
+        const body = await this.request("GET", path);
+        return HistoryResponse.parse(body);
+    }
+    async getConfigEntryDiagnostics(configEntryId, dataSchema) {
+        const path = `/api/diagnostics/config_entry/${encodeURIComponent(configEntryId)}`;
+        const body = ConfigEntryDiagnostics.parse(await this.request("GET", path));
+        return dataSchema.parse(body.data);
+    }
+    buildServicePath(domain, service, options) {
+        const base = `/api/services/${encodeURIComponent(domain)}/${encodeURIComponent(service)}`;
+        if (options?.returnResponse === true) {
+            return `${base}?return_response`;
+        }
+        return base;
+    }
+    async request(method, path, options = {}) {
+        const response = await this.rawRequest(method, path, options.body);
+        await this.assertOk(response, method, path, options.notFoundResource);
+        const text = await response.text();
+        if (text === "") {
+            return undefined;
+        }
+        return RawJson.parse(JSON.parse(text));
+    }
+    async assertOk(response, method, path, notFoundResource) {
+        if (response.status === 401 || response.status === 403) {
+            const text = await response.text();
+            throw new HaAuthError(response.status, text);
+        }
+        if (response.status === 404) {
+            const text = await response.text();
+            throw new HaNotFoundError(notFoundResource ?? path, text);
+        }
+        if (!response.ok) {
+            const text = await response.text();
+            throw new HaApiError(`Home Assistant ${method} ${path} failed: ${String(response.status)} ${response.statusText}`, response.status, text);
+        }
+    }
+    rawRequest(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.token}`,
+        };
+        const init = { method, headers };
+        if (method === "POST") {
+            headers["Content-Type"] = "application/json";
+            init.body = JSON.stringify(body ?? {});
+        }
+        return fetch(url, init);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/rest/client.js.map

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

package/dist/rest/errors.d.ts

@@ -0,0 +1,12 @@
+export declare class HaApiError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(message: string, status: number, body: string);
+}
+export declare class HaAuthError extends HaApiError {
+    constructor(status: number, body: string);
+}
+export declare class HaNotFoundError extends HaApiError {
+    constructor(resource: string, body: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/rest/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/rest/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,YAAmB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAK/D;CACF;AAED,qBAAa,WAAY,SAAQ,UAAU;IACzC,YAAmB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAO9C;CACF;AAED,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,YAAmB,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAGhD;CACF"}

package/dist/rest/errors.js

@@ -0,0 +1,23 @@
+export class HaApiError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.name = "HaApiError";
+        this.status = status;
+        this.body = body;
+    }
+}
+export class HaAuthError extends HaApiError {
+    constructor(status, body) {
+        super(`Home Assistant rejected the access token (${String(status)})`, status, body);
+        this.name = "HaAuthError";
+    }
+}
+export class HaNotFoundError extends HaApiError {
+    constructor(resource, body) {
+        super(`Home Assistant resource not found: ${resource}`, 404, body);
+        this.name = "HaNotFoundError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/rest/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/rest/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnB,MAAM,CAAS;IACf,IAAI,CAAS;IAE7B,YAAmB,OAAe,EAAE,MAAc,EAAE,IAAY;QAC9D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,UAAU;IACzC,YAAmB,MAAc,EAAE,IAAY;QAC7C,KAAK,CACH,6CAA6C,MAAM,CAAC,MAAM,CAAC,GAAG,EAC9D,MAAM,EACN,IAAI,CACL,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAmB,QAAgB,EAAE,IAAY;QAC/C,KAAK,CAAC,sCAAsC,QAAQ,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/rest/schemas.d.ts

@@ -0,0 +1,124 @@
+import { z } from "zod";
+export declare const EntityState: z.ZodObject<{
+    entity_id: z.ZodString;
+    state: z.ZodString;
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    last_changed: z.ZodOptional<z.ZodString>;
+    last_updated: z.ZodOptional<z.ZodString>;
+    last_reported: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        parent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type EntityState = z.infer<typeof EntityState>;
+export declare const HaConfig: z.ZodObject<{
+    location_name: z.ZodString;
+    latitude: z.ZodNumber;
+    longitude: z.ZodNumber;
+    elevation: z.ZodNumber;
+    time_zone: z.ZodString;
+    version: z.ZodString;
+    components: z.ZodArray<z.ZodString>;
+    unit_system: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$loose>;
+export type HaConfig = z.infer<typeof HaConfig>;
+/**
+ * Default POST /api/services/{domain}/{service} response: a list of entity
+ * states that changed as a result of the call.
+ */
+export declare const ServiceCallChangedStates: z.ZodArray<z.ZodObject<{
+    entity_id: z.ZodString;
+    state: z.ZodString;
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    last_changed: z.ZodOptional<z.ZodString>;
+    last_updated: z.ZodOptional<z.ZodString>;
+    last_reported: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        parent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+export type ServiceCallChangedStates = z.infer<typeof ServiceCallChangedStates>;
+/**
+ * Response shape when the request includes `?return_response`. Home Assistant
+ * returns an object with `service_response` (service-provided payload) and
+ * optionally `changed_states`. We keep the schema `.loose()` so additional
+ * top-level fields HA may add in future versions don't break parsing.
+ */
+export declare const ServiceCallWithResponse: z.ZodObject<{
+    service_response: z.ZodUnknown;
+    changed_states: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        entity_id: z.ZodString;
+        state: z.ZodString;
+        attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        last_changed: z.ZodOptional<z.ZodString>;
+        last_updated: z.ZodOptional<z.ZodString>;
+        last_reported: z.ZodOptional<z.ZodString>;
+        context: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            parent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$loose>;
+export type ServiceCallWithResponse = z.infer<typeof ServiceCallWithResponse>;
+export declare const ServiceCallResult: z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+    entity_id: z.ZodString;
+    state: z.ZodString;
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    last_changed: z.ZodOptional<z.ZodString>;
+    last_updated: z.ZodOptional<z.ZodString>;
+    last_reported: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        parent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>, z.ZodObject<{
+    service_response: z.ZodUnknown;
+    changed_states: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        entity_id: z.ZodString;
+        state: z.ZodString;
+        attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        last_changed: z.ZodOptional<z.ZodString>;
+        last_updated: z.ZodOptional<z.ZodString>;
+        last_reported: z.ZodOptional<z.ZodString>;
+        context: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            parent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$loose>]>;
+export type ServiceCallResult = z.infer<typeof ServiceCallResult>;
+export declare const FireEventResponse: z.ZodObject<{
+    message: z.ZodString;
+}, z.core.$strip>;
+export type FireEventResponse = z.infer<typeof FireEventResponse>;
+export declare const HistoryResponse: z.ZodArray<z.ZodArray<z.ZodObject<{
+    entity_id: z.ZodString;
+    state: z.ZodString;
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    last_changed: z.ZodOptional<z.ZodString>;
+    last_updated: z.ZodOptional<z.ZodString>;
+    last_reported: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        parent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>>;
+export type HistoryResponse = z.infer<typeof HistoryResponse>;
+export declare const ConfigEntryDiagnostics: z.ZodObject<{
+    home_assistant: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    custom_components: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    integration_manifest: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    setup_times: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    data: z.ZodUnknown;
+    issues: z.ZodArray<z.ZodUnknown>;
+}, z.core.$loose>;
+export type ConfigEntryDiagnostics = z.infer<typeof ConfigEntryDiagnostics>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/rest/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/rest/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,WAAW;;;;;;;;;;;;iBActB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,QAAQ;;;;;;;;;iBAWX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;kBAAuB,CAAC;AAE7D,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;iBAK1B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAG5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,iBAAiB;;iBAE5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,eAAe;;;;;;;;;;;;mBAAgC,CAAC;AAE7D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,sBAAsB;;;;;;;iBASzB,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/rest/schemas.js

@@ -0,0 +1,64 @@
+import { z } from "zod";
+export const EntityState = z.object({
+    entity_id: z.string(),
+    state: z.string(),
+    attributes: z.record(z.string(), z.unknown()),
+    last_changed: z.string().optional(),
+    last_updated: z.string().optional(),
+    last_reported: z.string().optional(),
+    context: z
+        .object({
+        id: z.string(),
+        parent_id: z.string().nullable().optional(),
+        user_id: z.string().nullable().optional(),
+    })
+        .optional(),
+});
+export const HaConfig = z
+    .object({
+    location_name: z.string(),
+    latitude: z.number(),
+    longitude: z.number(),
+    elevation: z.number(),
+    time_zone: z.string(),
+    version: z.string(),
+    components: z.array(z.string()),
+    unit_system: z.record(z.string(), z.string()),
+})
+    .loose();
+/**
+ * Default POST /api/services/{domain}/{service} response: a list of entity
+ * states that changed as a result of the call.
+ */
+export const ServiceCallChangedStates = z.array(EntityState);
+/**
+ * Response shape when the request includes `?return_response`. Home Assistant
+ * returns an object with `service_response` (service-provided payload) and
+ * optionally `changed_states`. We keep the schema `.loose()` so additional
+ * top-level fields HA may add in future versions don't break parsing.
+ */
+export const ServiceCallWithResponse = z
+    .object({
+    service_response: z.unknown(),
+    changed_states: z.array(EntityState).optional(),
+})
+    .loose();
+export const ServiceCallResult = z.union([
+    ServiceCallChangedStates,
+    ServiceCallWithResponse,
+]);
+export const FireEventResponse = z.object({
+    message: z.string(),
+});
+export const HistoryResponse = z.array(z.array(EntityState));
+export const ConfigEntryDiagnostics = z
+    .object({
+    home_assistant: z.record(z.string(), z.unknown()),
+    custom_components: z.record(z.string(), z.unknown()),
+    integration_manifest: z.record(z.string(), z.unknown()),
+    setup_times: z.record(z.string(), z.unknown()),
+    data: z.unknown(),
+    issues: z.array(z.unknown()),
+})
+    .loose();
+//# sourceMappingURL=schemas.js.map

package/dist/rest/schemas.js.map

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

package/dist/schema/types.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Type-level schema describing a specific Home Assistant instance's entities,
+ * services, and events. Generated by the `ha-codegen` CLI (see src/codegen/)
+ * from a live HA instance. Consumers parameterize the client classes with
+ * their generated schema to get literal-union autocomplete and compile-time
+ * rejection of unknown entity IDs, domains, services, or event types.
+ *
+ * The default schema (`DefaultHaSchema`) keeps the original loose behavior so
+ * call sites that don't supply a schema see no type changes.
+ */
+export type HaFieldType = "number" | "string" | "boolean" | "entity" | "object" | "unknown";
+export type HaServiceFieldMeta = {
+    readonly type: HaFieldType;
+    readonly required?: boolean;
+    /** For `type: "entity"` fields: narrow to entity IDs whose domain matches. */
+    readonly domain?: string;
+    /** For select-style fields, the allowed literal values. */
+    readonly options?: readonly string[];
+};
+export type HaServiceMeta = {
+    readonly fields: Readonly<Record<string, HaServiceFieldMeta>>;
+    readonly target?: {
+        readonly domain: string;
+    } | undefined;
+    readonly response?: boolean;
+};
+export type HaEntityMeta = {
+    readonly domain: string;
+    readonly attributes: Readonly<Record<string, unknown>>;
+};
+export type HaSchema = {
+    entities: Readonly<Record<string, HaEntityMeta>>;
+    services: Readonly<Record<string, Readonly<Record<string, HaServiceMeta>>>>;
+    events: string;
+    eventData: Readonly<Record<string, unknown>>;
+};
+/**
+ * Loose default used when no schema is supplied. Accepts any string for
+ * entity IDs / domains / services / events and `Record<string, unknown>` for
+ * service data — matching the pre-typed behavior.
+ */
+export type DefaultHaSchema = {
+    entities: Record<string, HaEntityMeta>;
+    services: Record<string, Record<string, HaServiceMeta>>;
+    events: string;
+    eventData: Record<string, unknown>;
+};
+type StringKeys<T> = Extract<keyof T, string>;
+/** Entity IDs registered in `S` (all of them if `S` is the default schema). */
+export type EntityId<S extends HaSchema> = StringKeys<S["entities"]>;
+/**
+ * Entity IDs whose domain is `D`. Narrowed when the schema has literal domains.
+ *
+ * For the loose {@link DefaultHaSchema} (entities keyed by `string` rather
+ * than literal IDs), no literal can extend the requested domain, so the
+ * mapped lookup collapses to `never`. Fall back to `EntityId<S>` in that
+ * case so stub-typed workflows still accept domain-prefixed literals.
+ */
+export type EntityIdByDomain<S extends HaSchema, D extends string> = string extends StringKeys<S["entities"]> ? EntityId<S> : {
+    [E in keyof S["entities"]]: S["entities"][E] extends {
+        domain: infer DD;
+    } ? DD extends D ? E : never : never;
+}[keyof S["entities"]] & string;
+/** Valid domain names registered in `S`. */
+export type Domain<S extends HaSchema> = StringKeys<S["services"]>;
+/** Valid service names registered under domain `D` in `S`. */
+export type Service<S extends HaSchema, D extends Domain<S>> = StringKeys<S["services"][D]>;
+/** Valid event types registered in `S`. */
+export type EventType<S extends HaSchema> = S["events"] & string;
+/** Translate a schema field meta to the TS type accepted in service data. */
+type FieldType<S extends HaSchema, F extends HaServiceFieldMeta> = F["type"] extends "number" ? number : F["type"] extends "string" ? string : F["type"] extends "boolean" ? boolean : F["type"] extends "entity" ? F["domain"] extends string ? EntityIdByDomain<S, F["domain"]> | readonly EntityIdByDomain<S, F["domain"]>[] : EntityId<S> | readonly EntityId<S>[] : F["type"] extends "object" ? Record<string, unknown> : unknown;
+type RequiredFieldKeys<Fields extends Record<string, HaServiceFieldMeta>> = {
+    [K in keyof Fields]: Fields[K]["required"] extends true ? K : never;
+}[keyof Fields];
+type OptionalFieldKeys<Fields extends Record<string, HaServiceFieldMeta>> = {
+    [K in keyof Fields]: Fields[K]["required"] extends true ? never : K;
+}[keyof Fields];
+type FieldsAsObject<S extends HaSchema, Fields extends Record<string, HaServiceFieldMeta>> = {
+    [K in RequiredFieldKeys<Fields>]: FieldType<S, Fields[K]>;
+} & {
+    [K in OptionalFieldKeys<Fields>]?: FieldType<S, Fields[K]>;
+};
+type TargetPart<S extends HaSchema, T> = T extends {
+    domain: infer TD extends string;
+} ? {
+    entity_id?: EntityIdByDomain<S, TD> | readonly EntityIdByDomain<S, TD>[];
+} : {
+    entity_id?: EntityId<S> | readonly EntityId<S>[];
+};
+/**
+ * Payload accepted by `callService(domain, service, ...)`. Includes:
+ * - the generated field shape for this service
+ * - an optional `entity_id` narrowed to same-domain entities when the service
+ *   declares a target selector (falls back to any entity ID when it doesn't)
+ */
+export type ServiceDataFor<S extends HaSchema, D extends Domain<S>, V extends Service<S, D>> = S["services"][D][V] extends HaServiceMeta ? FieldsAsObject<S, S["services"][D][V]["fields"]> & TargetPart<S, S["services"][D][V]["target"]> : never;
+/** Per-event data shape if the schema provides one, else `unknown`. */
+export type EventDataFor<S extends HaSchema, E extends EventType<S>> = E extends keyof S["eventData"] ? S["eventData"][E] : unknown;
+/**
+ * Typed attribute shape for an entity when the schema lists it. Attributes
+ * in HA are fluid so we keep this as a partial of the observed snapshot plus
+ * an open index signature rather than pretending to be exhaustive.
+ */
+export type EntityAttributesFor<S extends HaSchema, E extends EntityId<S>> = S["entities"][E] extends {
+    attributes: infer A;
+} ? Partial<A> & Record<string, unknown> : Record<string, unknown>;
+/**
+ * Structural shape of an EntityState response (parallel to the Zod-inferred
+ * `EntityState` from rest/schemas.ts) with the entity_id narrowed to a
+ * specific literal and attributes typed per schema.
+ */
+export type EntityStateFor<S extends HaSchema, E extends EntityId<S>> = {
+    entity_id: E;
+    state: string;
+    attributes: EntityAttributesFor<S, E>;
+    last_changed?: string;
+    last_updated?: string;
+    last_reported?: string;
+    context?: {
+        id: string;
+        parent_id?: string | null;
+        user_id?: string | null;
+    };
+};
+/**
+ * Structural shape of an EventEnvelope with the event data narrowed per
+ * schema. Parallel to the Zod-inferred `EventEnvelope` from ws/messages.ts.
+ */
+export type EventEnvelopeFor<S extends HaSchema, E extends EventType<S>> = {
+    data?: EventDataFor<S, E> extends Record<string, unknown> ? EventDataFor<S, E> : Record<string, unknown>;
+    event_type?: E;
+    time_fired?: string;
+    origin?: string;
+    context?: Record<string, unknown>;
+    variables?: Record<string, unknown>;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/schema/types.d.ts.map

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

package/dist/schema/types.js

@@ -0,0 +1,12 @@
+/**
+ * Type-level schema describing a specific Home Assistant instance's entities,
+ * services, and events. Generated by the `ha-codegen` CLI (see src/codegen/)
+ * from a live HA instance. Consumers parameterize the client classes with
+ * their generated schema to get literal-union autocomplete and compile-time
+ * rejection of unknown entity IDs, domains, services, or event types.
+ *
+ * The default schema (`DefaultHaSchema`) keeps the original loose behavior so
+ * call sites that don't supply a schema see no type changes.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/schema/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/schema/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/shared/config.d.ts

@@ -0,0 +1,6 @@
+export type HomeAssistantConfig = {
+    baseUrl: string;
+    token: string;
+};
+export declare function normalizeBaseUrl(baseUrl: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/shared/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/shared/config.js

@@ -0,0 +1,4 @@
+export function normalizeBaseUrl(baseUrl) {
+    return baseUrl.replace(/\/+$/u, "");
+}
+//# sourceMappingURL=config.js.map

package/dist/shared/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/ws/client.d.ts

@@ -0,0 +1,58 @@
+import type { EntityState } from "../rest/schemas.js";
+import type { DefaultHaSchema, Domain, EventType, HaSchema, Service, ServiceDataFor } from "../schema/types.js";
+import type { HomeAssistantConfig } from "../shared/config.js";
+import type { EntityRegistryEntry as EntityRegistryEntryType } from "./messages.js";
+import type { WebSocketLikeCtor } from "./socket-helpers.js";
+import type { EventHandler } from "./subscriptions.js";
+export type HomeAssistantEventClientOptions = {
+    reconnect?: boolean;
+    initialReconnectDelayMs?: number;
+    maxReconnectDelayMs?: number;
+    pingIntervalMs?: number;
+    webSocketImpl?: WebSocketLikeCtor;
+};
+type ConnectionState = "idle" | "connecting" | "authenticated" | "closed" | "error";
+export type ConnectionStateListener = (state: ConnectionState, detail?: unknown) => void;
+export declare class HomeAssistantEventClient<S extends HaSchema = DefaultHaSchema> {
+    private readonly wsUrl;
+    private readonly token;
+    private readonly opts;
+    private readonly webSocketImpl;
+    private readonly subscriptions;
+    private readonly pending;
+    private readonly stateListeners;
+    private socket;
+    private nextId;
+    private closedByUser;
+    private reconnectAttempt;
+    private pingTimer;
+    constructor(config: HomeAssistantConfig, options?: HomeAssistantEventClientOptions);
+    onConnectionChange(listener: ConnectionStateListener): () => void;
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    subscribeEvents(eventType: EventType<S>, handler: EventHandler): Promise<() => Promise<void>>;
+    subscribeTrigger(trigger: Record<string, unknown>, handler: EventHandler): Promise<() => Promise<void>>;
+    callService<D extends Domain<S>, V extends Service<S, D>>(domain: D, service: V, data?: ServiceDataFor<S, D, V>, target?: Record<string, unknown>): Promise<unknown>;
+    getStates(): Promise<EntityState[]>;
+    getEntityRegistry(): Promise<EntityRegistryEntryType[]>;
+    private openAndAuth;
+    private attachMessageHandler;
+    private attachCloseHandler;
+    private handleRawMessage;
+    private dispatchEvent;
+    private dispatchResult;
+    private performAuth;
+    private resubscribeAll;
+    private subscribeOnServer;
+    private unsubscribe;
+    private sendRequest;
+    private requireOpenSocket;
+    private scheduleReconnect;
+    private startPingTimer;
+    private stopPingTimer;
+    private failAllPending;
+    private setState;
+    private emitError;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/ws/client.d.ts.map

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