@smarthome.exchange/integrations 1.0.0 → 3.0.0

package/ts/core/types.ts

@@ -1,4 +1,5 @@
 import * as plugins from '../plugins.js';
+import type { NoSqlConfigStore } from './classes.configstore.js';
 
 export type TDiscoverySource =
   | 'mdns'
@@ -112,11 +113,18 @@ export interface IDiscoveryDescriptorOptions {
 }
 
 export interface IIntegrationSetupContext {
+  /** Explicit owning home selected by the embedding host, never by device configuration. */
+  readonly homeId?: string;
   logger?: ILogger;
   configStore?: IConfigStore;
   abortSignal?: AbortSignal;
 }
 
+export interface INativeIntegrationSetupContext extends IIntegrationSetupContext {
+  readonly homeId: string;
+  readonly configStore?: NoSqlConfigStore;
+}
+
 export type TEntityPlatform =
   | 'light'
   | 'switch'
@@ -195,6 +203,8 @@ export interface IIntegrationRuntime {
   callService?(requestArg: IServiceCallRequest): Promise<IServiceCallResult>;
   writeFeature?(requestArg: IDeviceFeatureWriteRequest, abortSignalArg?: AbortSignal): Promise<IServiceCallResult>;
   destroy(): Promise<void>;
+  /** Explicit retry of retained cleanup, without reopening or replaying transport work. */
+  retryCleanup?(): Promise<void>;
 }
 
 export type TConfigFlowStepKind = 'form' | 'wait' | 'done' | 'error';
@@ -211,8 +221,16 @@ export interface IConfigFlowField {
 }
 
 export interface IConfigFlowContext {
+  /** Explicit owning home selected by the embedding host. This is not an authentication token. */
+  readonly homeId?: string;
   logger?: ILogger;
   configStore?: IConfigStore;
+  abortSignal?: AbortSignal;
+}
+
+export interface INativeConfigFlowContext extends IConfigFlowContext {
+  readonly homeId: string;
+  readonly configStore?: NoSqlConfigStore;
 }
 
 export interface IConfigFlowStep<TConfig = unknown> {