# airdress.household.*

{/* Generated by scripts/generate-event-reference.mjs from https://schemas.airdress.co/operator/events/v1.json (operator v0.1.138).
    Do not edit by hand: run `pnpm generate:event-reference` and commit the result. */}

The events in the `airdress.household` family. How to read a section, and what
each audience means, is on the [event reference](/events/) page.

## `airdress.household.setting.announced`

Owner info App stream Functions

The owner's devices were told a household setting changed.

The change itself is the journal's `airdress.household.setting.changed`; this is its announcement, one per airdress the owner has a device on.

**Audience: owner.** About the airdress as a whole. Only the owner receives it: the owner's devices and the owner's subscriptions.

**Where it goes**

- **The operator's journal**, as one log line at this level, and **the event log**, where `airdress events tail` reads it.
- **Subscriptions** that name it, within its audience.
- **The app's event stream**, as `household_setting_changed`: devices it concerns hear of it at once.
- **Functions bound to this operator's events** (`source: operator`).

**Versions**

- Version 1: first carried by operator v0.1.133.

**Data**

| Field | Type | Required | Description |
| ----- | ---- | -------- | ----------- |
| `airdress` | string | yes |  |
| `at` | string | yes |  |
| `setting` | string | yes |  |
| `value` | string | yes |  |

<details>
<summary>JSON Schema</summary>

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "The owner's devices were told a household setting changed.\n\nThe change itself is the journal's `airdress.household.setting.changed`; this is its announcement, one per airdress the owner has a device on.",
  "properties": {
    "airdress": {
      "type": "string"
    },
    "at": {
      "type": "string"
    },
    "setting": {
      "type": "string"
    },
    "value": {
      "type": "string"
    }
  },
  "required": [
    "airdress",
    "at",
    "setting",
    "value"
  ],
  "title": "HouseholdSettingChanged",
  "type": "object"
}
```

</details>

## `airdress.household.setting.changed`

Owner info Functions

The owner changed a household setting: the member-reset policy (`value`) or the discovery ceilings.

**Audience: owner.** About the airdress as a whole. Only the owner receives it: the owner's devices and the owner's subscriptions.

**Where it goes**

- **The operator's journal**, as one log line at this level, and **the event log**, where `airdress events tail` reads it.
- **Subscriptions** that name it, within its audience.
- **Functions bound to this operator's events** (`source: operator`).

**Versions**

- Version 1: first carried by operator v0.1.138.

**Data**

| Field | Type | Required | Description |
| ----- | ---- | -------- | ----------- |
| `discoverable_ceiling` | string or null | no |  |
| `searchable_ceiling` | string or null | no |  |
| `setting` | string | yes |  |
| `value` | string or null | no |  |

<details>
<summary>JSON Schema</summary>

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "The owner changed a household setting: the member-reset policy (`value`) or the discovery ceilings.",
  "properties": {
    "discoverable_ceiling": {
      "type": [
        "string",
        "null"
      ]
    },
    "searchable_ceiling": {
      "type": [
        "string",
        "null"
      ]
    },
    "setting": {
      "type": "string"
    },
    "value": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "setting"
  ],
  "title": "HouseholdSettingChanged",
  "type": "object"
}
```

</details>