# app.thesocialwire.preferences

> Published by [samclemente.me](https://lexicon.garden/identity/did:plc:qy5pluw2bsuq2x6albsgkvx3)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:qy5pluw2bsuq2x6albsgkvx3/app.thesocialwire.preferences)
- [Documentation](https://lexicon.garden/lexicon/did:plc:qy5pluw2bsuq2x6albsgkvx3/app.thesocialwire.preferences/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:qy5pluw2bsuq2x6albsgkvx3/app.thesocialwire.preferences/examples)

## Definitions

### `app.thesocialwire.preferences`

**Type**: `record`

Account-level preferences for The Social Wire. This record stores non-sensitive preferences only; third-party access tokens and secrets must not be stored in ATProto repos.

**Key**: `literal:self`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `createdAt` | `string` (datetime) | Yes | ISO 8601 timestamp when this preferences record was created. |
| `updatedAt` | `string` (datetime) | Yes | ISO 8601 timestamp when this preferences record was last updated. |
| `visibleFeeds` | `array` | No | Ordered top-level reader feeds shown in clients. At least one value must be retained by clients. |
| `readLaterService` | `string` | No | The read-later provider used by the /saved surface. |
| `rssArticleOpenMode` | `string` | No | Whether RSS articles open in The Social Wire's native feed-content reader or on the publisher's original site. |
| `readLaterConnections` | `object` | No | Non-sensitive connection metadata for read-later providers. Do not store API tokens, passwords, refresh tokens, or secrets here. |
| `feedsWithUnreadCounts` | `array` | No | Top-level reader feeds whose unread badges are shown. Values should also appear in visibleFeeds. |
| `showTopLevelFeedUnreadCounts` | `boolean` | No | Legacy global switch for aggregate unread badges. New clients use feedsWithUnreadCounts. |

### `app.thesocialwire.preferences#connection`

**Type**: `object`

Non-sensitive provider connection metadata.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `connectedAt` | `string` (datetime) | No | ISO 8601 timestamp when the provider was connected. |
| `accountLabel` | `string` | No | User-visible account identifier, such as a username or email. Do not store credentials. |

## Raw Schema

```json
{
  "id": "app.thesocialwire.preferences",
  "defs": {
    "main": {
      "key": "literal:self",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "createdAt",
          "updatedAt"
        ],
        "properties": {
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "maxLength": 64,
            "description": "ISO 8601 timestamp when this preferences record was created."
          },
          "updatedAt": {
            "type": "string",
            "format": "datetime",
            "maxLength": 64,
            "description": "ISO 8601 timestamp when this preferences record was last updated."
          },
          "visibleFeeds": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 32,
              "knownValues": [
                "readLater",
                "archive",
                "subscribed",
                "following"
              ]
            },
            "description": "Ordered top-level reader feeds shown in clients. At least one value must be retained by clients."
          },
          "readLaterService": {
            "type": "string",
            "maxLength": 32,
            "description": "The read-later provider used by the /saved surface.",
            "knownValues": [
              "latr-link",
              "latrkit",
              "instapaper",
              "omnivore",
              "readwise-reader",
              "raindrop"
            ]
          },
          "rssArticleOpenMode": {
            "type": "string",
            "maxLength": 16,
            "description": "Whether RSS articles open in The Social Wire's native feed-content reader or on the publisher's original site.",
            "knownValues": [
              "reader",
              "original"
            ]
          },
          "readLaterConnections": {
            "type": "object",
            "properties": {
              "omnivore": {
                "ref": "#connection",
                "type": "ref"
              },
              "raindrop": {
                "ref": "#connection",
                "type": "ref"
              },
              "instapaper": {
                "ref": "#connection",
                "type": "ref"
              },
              "readwise-reader": {
                "ref": "#connection",
                "type": "ref"
              }
            },
            "description": "Non-sensitive connection metadata for read-later providers. Do not store API tokens, passwords, refresh tokens, or secrets here."
          },
          "feedsWithUnreadCounts": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 32,
              "knownValues": [
                "readLater",
                "archive",
                "subscribed",
                "following"
              ]
            },
            "description": "Top-level reader feeds whose unread badges are shown. Values should also appear in visibleFeeds."
          },
          "showTopLevelFeedUnreadCounts": {
            "type": "boolean",
            "description": "Legacy global switch for aggregate unread badges. New clients use feedsWithUnreadCounts."
          }
        }
      },
      "description": "Account-level preferences for The Social Wire. This record stores non-sensitive preferences only; third-party access tokens and secrets must not be stored in ATProto repos."
    },
    "connection": {
      "type": "object",
      "properties": {
        "connectedAt": {
          "type": "string",
          "format": "datetime",
          "maxLength": 64,
          "description": "ISO 8601 timestamp when the provider was connected."
        },
        "accountLabel": {
          "type": "string",
          "maxLength": 320,
          "description": "User-visible account identifier, such as a username or email. Do not store credentials."
        }
      },
      "description": "Non-sensitive provider connection metadata."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```