AccessControl & Expose#

local handle = expose(obj, typ, opcje)

-- Przekaźnik GPIO
local relay = GPIO_DOUT:new("RELAY1", 17, {activeLow = true})
expose(relay, "switch", {name = "Lampa salon"})

-- Obiekt z OM registry
expose(_:get("CLU.DOUT1"), "switch", {name = "Lampa kuchnia"})

-- Czujnik temperatury (wartość statyczna lub dynamiczna)
expose({value = 0, get = function(self) return self.value end}, "temperature", {
    name = "Temperatura salon"
})

-- Scena
scene("wieczor", function()
    _:get("CLU.DOUT1"):execute(DOUT.METHOD_SWITCH_ON)
    _:get("CLU.DOUT2"):execute(DOUT.METHOD_SWITCH_OFF)
end)
expose(getScene("wieczor"), "scene", {name = "Tryb wieczorny"})

local h = expose(obj, "switch", {name = "Lampa"})
h:name("Nowa nazwa")    -- zmień nazwę
h:readonly()             -- ustaw jako tylko-odczyt
h:mqttOnly()             -- wyłącz HomeKit
h:homekitOnly()          -- wyłącz MQTT
h:group("salon")         -- ustaw grupę

expose(obj, "switch"):name("Lampa"):readonly():mqttOnly()

h:getValue()        -- odczytaj aktualną wartość
h:setValue(1)        -- ustaw wartość (emituje state_changed)
                     -- nie działa gdy readonly

-- Zmień nazwę (aktualizuje discovery w HA i HomeKit)
h:rename("Zmieniona nazwa")

-- Zmień opcje (merge)
h:update({readonly = true})
h:update({mqtt = false})          -- ukryj z MQTT, zostaw HomeKit
h:update({homekit = false})       -- ukryj z HomeKit, zostaw MQTT

h:unexpose()        -- usuń obiekt z HA i HomeKit
h:isExposed()       -- sprawdź czy nadal wyeksponowany (true/false)

h:getPath()         -- zwraca ścieżkę, np. "vclu:switch1" lub "CLU.DOU123"

local count = exposeRegistry()
-- Zwraca: liczba nowo wyeksponowanych obiektów

1. Ręczny expose() w user.lua     (najwyższy)
2. Reguły AccessControl           (środkowy)
3. exposeRegistry() automatyczne  (najniższy)

-- user.lua
expose(_:get("CLU.DOUT1"), "switch", {name = "Moja lampa", readonly = true})

-- Później (np. w bootstrap)
exposeRegistry()  -- pominie CLU.DOUT1, bo już wyeksponowany

# access_control.yaml
profiles:
  full-access:             # wbudowany, nie można usunąć
    default: full

  sensors-only:
    default: hidden        # domyślnie ukryj wszystko
    objects:
      CLU.TEMP: readonly   # czujniki widoczne jako readonly
      CLU.HUM: readonly

  lights:
    default: hidden
    objects:
      CLU.LED1: full       # światła sterowalane
      CLU.LED2: full

assignments:
  mqtt: [full-access]      # MQTT widzi wszystko
  homekit: [full-access]   # HomeKit widzi wszystko

MQTT      → [full-access]
HomeKit   → [full-access]
Bot "Claude Code"     → [full-access]
Bot "Home AI"         → [sensors-only, lights]

full > readonly > hidden

-- Odczytaj dostęp (uwzględnia profile)
local level = AccessControl.get("mqtt", "CLU.DOUT1")   -- "full"/"readonly"/"hidden"

-- Helpersy
AccessControl.isHidden("mqtt", "CLU.DOUT1")     -- true/false
AccessControl.isReadonly("mqtt", "CLU.DOUT1")   -- true/false
AccessControl.canControl("mqtt", "CLU.DOUT1")   -- true = level == "full"
AccessControl.canPublish("mqtt", "CLU.DOUT1")   -- true = level ~= "hidden"

-- Rozstrzyganie dla listy profili (np. bota MCP)
local level = AccessControl.resolveAccess({"sensors-only", "lights"}, "CLU.LED1")
-- → "full"

1. expose() opcje         →  czy obiekt w ogóle istnieje dla integracji
2. Profile (AccessControl) →  czy klient ma dostęp (full/readonly/hidden)
3. Merge profili           →  most permissive wins przy wielu profilach

-- Przy eksponowaniu
expose(obj, "switch", {name = "Lampa", mqtt = false})

-- Albo w runtime na istniejącym handle
h:update({mqtt = false})

-- Przy eksponowaniu
expose(obj, "switch", {name = "Lampa", homekit = false})

-- Albo w runtime
h:update({homekit = false})

-- Dla obu integracji naraz
h:update({readonly = true})

h:unexpose()

h:rename("Nowa nazwa")
-- HA: re-publikuje discovery z nową nazwą
-- HomeKit: aktualizuje przy następnym odświeżeniu

local lock = expose(_:get("CLU.LOCK1"), "lock", {name = "Zamek drzwi"})

-- Scena "nocny" - wyłącz sterowanie zamkiem
scene("tryb_nocny", function()
    lock:update({readonly = true})
end)

-- Scena "dzienny" - przywróć pełne sterowanie
scene("tryb_dzienny", function()
    lock:update({readonly = false})
end)

-- user.lua

-- 1. Ręcznie eksponuj z własną nazwą i ustawieniami
expose(_:get("CLU.DOUT1"), "switch", {
    name = "Lampa salon",
    readonly = true,
    homekit = false
})

-- 2. Reszta obiektów z registry - automatycznie
exposeRegistry()
-- CLU.DOUT1 jest pominięty (już wyeksponowany ręcznie)
-- Reszta obiektów eksponowana z domyślnymi nazwami

local MySwitch = {}
function MySwitch:new()
    return setmetatable({_value = 0, _cbs = {}}, {__index = self})
end
function MySwitch:get(f) return self._value end
function MySwitch:set(f, v) self._value = v; self:_notify() end
function MySwitch:onChange(cb)
    table.insert(self._cbs, cb)
    return function()  -- MUSI zwrócić funkcję unsubscribe!
        for i, c in ipairs(self._cbs) do
            if c == cb then table.remove(self._cbs, i); break end
        end
    end
end
function MySwitch:_notify()
    for _, cb in ipairs(self._cbs) do cb(self._value) end
end

local sw = MySwitch:new()
expose(sw, "switch", {name = "Mój przełącznik"})
-- Teraz sw:set(0, 1) automatycznie aktualizuje stan w HA/HomeKit

-- Eksponuj obiekt na 5 minut (np. do testów)
local h = expose(obj, "switch", {name = "Tymczasowy"})

after(5 * 60 * 1000, function()
    h:unexpose()
    log.info("Tymczasowy obiekt usunięty")
end)

profiles:
  full-access:
    default: full

  lights-only:
    default: hidden
    objects:
      CLU.DOU0001: full
      CLU.DOU0002: full

assignments:
  mqtt: [full-access]
  homekit: [lights-only]