# airdress.key_package.*

{/* 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.key_package` family. How to read a section, and what
each audience means, is on the [event reference](/events/) page.

## `airdress.key_package.retired_form_purged`

Owner warn Functions

Pre-cutover key packages were discarded; v2 ones replace them in the same reconcile.

**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 |
| ----- | ---- | -------- | ----------- |
| `airdress` | string | yes |  |
| `purged` | integer (uint) | yes |  |

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

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "Pre-cutover key packages were discarded; v2 ones replace them in the same reconcile.",
  "properties": {
    "airdress": {
      "type": "string"
    },
    "purged": {
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "airdress",
    "purged"
  ],
  "title": "KeyPackageRetiredFormPurged",
  "type": "object"
}
```

</details>

## `airdress.key_package.undecodable`

Owner warn Functions

A stored key package could not be inspected for its identity form, so the purge of retired forms left it in place. Carries the package's storage id in hex, never the package.

**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 |
| ----- | ---- | -------- | ----------- |
| `airdress` | string | yes |  |
| `kid` | string | yes | The key package's storage id, hex. |
| `reason` | string | yes |  |

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

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "A stored key package could not be inspected for its identity form, so the purge of retired forms left it in place. Carries the package's storage id in hex, never the package.",
  "properties": {
    "airdress": {
      "type": "string"
    },
    "kid": {
      "description": "The key package's storage id, hex.",
      "type": "string"
    },
    "reason": {
      "type": "string"
    }
  },
  "required": [
    "airdress",
    "kid",
    "reason"
  ],
  "title": "KeyPackageUndecodable",
  "type": "object"
}
```

</details>