@glasshome/sync-layer 0.4.0 → 0.5.0

package/dist/testing/fixtures.d.ts

@@ -1,161 +0,0 @@
-/**
- * Fixture utilities
- *
- * Helper functions for creating and loading test fixtures.
- *
- * @packageDocumentation
- */
-export { createDemoFixtures } from "../demo/demo-data";
-import type { EntityRegistryEntry } from "@glasshome/ha-types";
-import type { HassEntity } from "../core/types";
-import type { EntityHistoryState } from "../history/types";
-import type { AreaRegistryEntry, DeviceRegistryEntry, Fixtures, FloorRegistryEntry, LabelRegistryEntry } from "./types";
-/**
- * Create a mock entity state
- *
- * @param entityId - Entity ID
- * @param overrides - Optional field overrides
- * @returns Mock entity state
- *
- * @example
- * ```typescript
- * const light = createEntity('light.kitchen', {
- *   state: 'on',
- *   attributes: { brightness: 255 },
- * });
- * ```
- */
-export declare function createEntity(entityId: string, overrides?: Partial<HassEntity>): HassEntity;
-/**
- * Create a mock entity registry entry
- *
- * @param entityId - Entity ID
- * @param overrides - Optional field overrides
- * @returns Mock registry entry
- *
- * @example
- * ```typescript
- * const entry = createEntityRegistryEntry('light.kitchen', {
- *   name: 'Kitchen Light',
- *   area_id: 'kitchen',
- * });
- * ```
- */
-export declare function createEntityRegistryEntry(entityId: string, overrides?: Partial<EntityRegistryEntry>): EntityRegistryEntry;
-/**
- * Create a mock area registry entry
- *
- * @param areaId - Area ID
- * @param overrides - Optional field overrides
- * @returns Mock area entry
- *
- * @example
- * ```typescript
- * const area = createArea('kitchen', {
- *   name: 'Kitchen',
- *   floor_id: 'ground_floor',
- * });
- * ```
- */
-export declare function createArea(areaId: string, overrides?: Partial<AreaRegistryEntry>): AreaRegistryEntry;
-/**
- * Create a mock device registry entry
- *
- * @param deviceId - Device ID
- * @param overrides - Optional field overrides
- * @returns Mock device entry
- *
- * @example
- * ```typescript
- * const device = createDevice('device_123', {
- *   name: 'Smart Light',
- *   area_id: 'kitchen',
- * });
- * ```
- */
-export declare function createDevice(deviceId: string, overrides?: Partial<DeviceRegistryEntry>): DeviceRegistryEntry;
-/**
- * Create a mock floor registry entry
- *
- * @param floorId - Floor ID
- * @param overrides - Optional field overrides
- * @returns Mock floor entry
- *
- * @example
- * ```typescript
- * const floor = createFloor('ground_floor', {
- *   name: 'Ground Floor',
- *   level: 0,
- * });
- * ```
- */
-export declare function createFloor(floorId: string, overrides?: Partial<FloorRegistryEntry>): FloorRegistryEntry;
-/**
- * Create a mock label registry entry
- *
- * @param labelId - Label ID
- * @param overrides - Optional field overrides
- * @returns Mock label entry
- *
- * @example
- * ```typescript
- * const label = createLabel('important', {
- *   name: 'Important',
- *   color: 'red',
- * });
- * ```
- */
-export declare function createLabel(labelId: string, overrides?: Partial<LabelRegistryEntry>): LabelRegistryEntry;
-/**
- * Create a basic fixture set for testing
- *
- * @returns Complete fixture set with basic entities
- *
- * @example
- * ```typescript
- * const fixtures = createBasicFixtures();
- * const mock = initMockHA(fixtures);
- * ```
- */
-export declare function createBasicFixtures(): Fixtures;
-/**
- * Load fixtures from JSON
- *
- * @param json - JSON string or object
- * @returns Parsed fixtures
- *
- * @example
- * ```typescript
- * const fixtures = loadFixture(`{
- *   "entities": { ... },
- *   "entityRegistry": [ ... ]
- * }`);
- * ```
- */
-export declare function loadFixture(json: string | object): Partial<Fixtures>;
-/**
- * Create a fixture set from partial data
- *
- * Fills in missing fields with defaults.
- *
- * @param partial - Partial fixture data
- * @returns Complete fixture set
- */
-export declare function createFixture(partial?: Partial<Fixtures>): Fixtures;
-/**
- * Create a history state point
- *
- * @param state - State value
- * @param timestamp - Unix timestamp in seconds
- * @param attributes - Optional attributes
- * @param lastChanged - Optional last changed timestamp (defaults to timestamp)
- * @returns History state point
- *
- * @example
- * ```typescript
- * const historyState = createHistoryState("20.5", Math.floor(Date.now() / 1000) - 3600, {
- *   unit_of_measurement: "°C",
- * });
- * ```
- */
-export declare function createHistoryState(state: string, timestamp: number, attributes?: Record<string, any>, lastChanged?: number): EntityHistoryState;

package/dist/testing/helpers.d.ts

@@ -1,160 +0,0 @@
-/**
- * Test helpers
- *
- * Utility functions for testing with the sync-layer.
- *
- * @packageDocumentation
- */
-import type { EntityRegistryEntry } from "@glasshome/ha-types";
-import { state } from "../core/store";
-import type { EntityId, HassEntity } from "../core/types";
-import type { MockConnection } from "./mock";
-import type { RegistryUpdateOptions, StateChangeOptions } from "./types";
-/**
- * Wait for a condition to be true
- *
- * @param condition - Function that returns true when ready
- * @param timeout - Maximum wait time in ms
- * @param interval - Check interval in ms
- * @returns Promise that resolves when condition is true
- *
- * @example
- * ```typescript
- * await waitFor(() => entity('light.kitchen').get()?.state === 'on', 1000);
- * ```
- */
-export declare function waitFor(condition: () => boolean, timeout?: number, interval?: number): Promise<void>;
-/**
- * Simulate state change event
- *
- * Updates entity state and emits event through mock connection.
- *
- * @param mockConnection - MockConnection instance
- * @param entityId - Entity ID
- * @param updates - State updates
- * @param options - Optional simulation options
- * @returns Promise that resolves when update completes
- *
- * @example
- * ```typescript
- * const mockConnection = new MockConnection(fixtures);
- * await simulateStateChange(mockConnection, 'light.kitchen', {
- *   state: 'on',
- *   attributes: { brightness: 255 },
- * });
- * ```
- */
-export declare function simulateStateChange(mockConnection: MockConnection, entityId: EntityId, updates: Partial<HassEntity>, options?: StateChangeOptions): Promise<void>;
-/**
- * Simulate registry update event
- *
- * Updates entity registry and emits event through mock connection.
- *
- * @param mockConnection - MockConnection instance
- * @param entityId - Entity ID
- * @param updates - Registry updates
- * @param options - Optional simulation options
- * @returns Promise that resolves when update completes
- *
- * @example
- * ```typescript
- * const mockConnection = new MockConnection(fixtures);
- * await simulateRegistryUpdate(mockConnection, 'light.kitchen', {
- *   name: 'New Name',
- *   area_id: 'bedroom',
- * });
- * ```
- */
-export declare function simulateRegistryUpdate(mockConnection: MockConnection, entityId: EntityId, updates: Partial<EntityRegistryEntry>, options?: RegistryUpdateOptions): Promise<void>;
-/**
- * Simulate multiple state changes in sequence
- *
- * @param mockConnection - MockConnection instance
- * @param changes - Array of state change configurations
- * @param delayBetween - Delay between changes in ms
- * @returns Promise that resolves when all changes complete
- *
- * @example
- * ```typescript
- * const mockConnection = new MockConnection(fixtures);
- * await simulateStateChanges(mockConnection, [
- *   { entityId: 'light.kitchen', updates: { state: 'on' } },
- *   { entityId: 'light.living_room', updates: { state: 'on' } },
- * ], 100);
- * ```
- */
-export declare function simulateStateChanges(mockConnection: MockConnection, changes: Array<{
-    entityId: EntityId;
-    updates: Partial<HassEntity>;
-}>, delayBetween?: number): Promise<void>;
-/**
- * Get current store state snapshot
- *
- * @returns Current store state
- */
-export declare function getStoreSnapshot(): typeof state;
-/**
- * Get entity from store
- *
- * @param entityId - Entity ID
- * @returns Entity state or undefined
- */
-export declare function getEntityFromStore(entityId: EntityId): HassEntity | undefined;
-/**
- * Get entity registry entry from store
- *
- * @param entityId - Entity ID
- * @returns Registry entry or undefined
- */
-export declare function getEntityRegistryFromStore(entityId: EntityId): EntityRegistryEntry | undefined;
-/**
- * Check if entity exists in store
- *
- * @param entityId - Entity ID
- * @returns True if entity exists
- */
-export declare function entityExistsInStore(entityId: EntityId): boolean;
-/**
- * Delay for specified time
- *
- * @param ms - Milliseconds to delay
- * @returns Promise that resolves after delay
- */
-export declare function delay(ms: number): Promise<void>;
-/**
- * Wait for mock connection to complete
- *
- * Helper to ensure fixtures are loaded before running tests.
- * Use after creating MockConnection and connecting.
- *
- * @example
- * ```typescript
- * const mockConnection = new MockConnection(fixtures);
- * await mockConnection.connect();
- * await waitForConnection();
- * // Now safe to run queries
- * ```
- */
-export declare function waitForConnection(): Promise<void>;
-/**
- * Create a spy function for testing
- *
- * @returns Spy function with call tracking
- *
- * @example
- * ```typescript
- * const spy = createSpy();
- * entities().byDomain('light').subscribe(spy);
- * // Check spy.calls, spy.callCount, etc.
- * ```
- */
-export declare function createSpy<T = unknown>(): SpyFunction<T>;
-/**
- * Spy function interface
- */
-export interface SpyFunction<T = unknown> {
-    (...args: T[]): void;
-    calls: T[][];
-    callCount: number;
-    reset(): void;
-}

package/dist/testing/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * Testing utilities for @glasshome/sync-layer
- *
- * Provides mock connections, fixtures, and helpers for testing
- * Home Assistant integrations without a live backend.
- *
- * @packageDocumentation
- */
-export type { AreaRegistryEntry, DeviceRegistryEntry, Fixtures, FloorRegistryEntry, LabelRegistryEntry, RegistryUpdateOptions, StateChangeOptions, } from "./types";
-export { MockConnection } from "./mock";
-export { createArea, createBasicFixtures, createDemoFixtures, createDevice, createEntity, createEntityRegistryEntry, createFixture, createFloor, createHistoryState, createLabel, loadFixture, } from "./fixtures";
-export type { SpyFunction } from "./helpers";
-export { createSpy, delay, entityExistsInStore, getEntityFromStore, getEntityRegistryFromStore, getStoreSnapshot, simulateRegistryUpdate, simulateStateChange, simulateStateChanges, waitFor, waitForConnection, } from "./helpers";