Method start

src/server.ts:191–280

()

  }

  public async start(): Promise<void> {
    if (this.config.bridge.disableIpc !== true) {
      this.initializeIpcEventHandlers()
    }

    const promises: Promise<void>[] = []

    // load the cached accessories
    await this.bridgeService.loadCachedPlatformAccessoriesFromDisk()

    // Validate Matter configuration up front so we know whether to expose
    // api.matter to plugins. Validator may strip invalid entries, so re-check
    // after. Caching the result avoids two more hasMatterConfig calls below.
    let matterIsConfigured = MatterConfigCollector.hasMatterConfig(this.config)
    if (matterIsConfigured) {
      await MatterConfigCollector.validateMatterConfig(this.config)
      matterIsConfigured = MatterConfigCollector.hasMatterConfig(this.config)
    }

    // Eagerly load the MatterAPI facade before plugins initialize, so api.matter
    // is defined when plugin code runs on Matter-enabled bridges. The heavy
    // MatterBridgeManager init still happens after plugins load (below) — only
    // the API surface needs to be ready early.
    if (matterIsConfigured) {
      await this.api.loadMatterAPI()
    }

    // initialize plugins
    await this.pluginManager.initializeInstalledPlugins()

    // Initialize Matter manager only if configured. Heavy Matter.js libraries
    // are loaded here (async), avoiding sync blocking during construction.
    if (matterIsConfigured) {
      // Dynamically import MatterBridgeManager only when needed
      // This prevents loading heavy Matter.js libraries when Matter is not configured
      const { MatterBridgeManager } = await import('./matter/MatterBridgeManager.js')

      // Create the manager
      this.matterManager = new MatterBridgeManager(
        this.config,
        this.api,
        this.externalPortService,
        this.pluginManager,
        this.options,
        this, // Pass server instance for registry access
      )

      // Set manager reference on API for getAccessoryState
      this.api._setMatterManager(this.matterManager)

      // Initialize Matter server for main bridge if enabled
      await this.matterManager.initialize()
    }

    if (this.config.platforms.length > 0) {
      promises.push(...this.loadPlatforms())
    }
    if (this.config.accessories.length > 0) {