Future: New Lexicons

[hzoo]

See https://bsky.app/profile/henryzoo.com/post/3lndvzwoawc2i
https://www.pfrazee.com/blog/lexicon-guidance
https://fediversereport.com/atproto-explained-lexicons-and-video/

tradeoff between reusing feed.post and introducing a new lexicon for any app.

• positive: chicken/egg issue with users for a new app is reduced since interop + network effect of bsky app itself. also moderation, search, etc is handled. posts on bsky automatically show up in the extension, even without them knowing in a sense.
• negative: constrained by bsky schema (limited char count for annotations), and future changes.

new lexicon:

• complete flexibility in schema.
• fragmentation, versioning, maintenance.

skylight re-use's video lexicon, reelo created own.

example with reddit-like voting

• it could be the exact same as a "like" but the direction property?
• other idea would be to add direction to app.bsky.feed.like as an unspecced field? One could assume that a like is automatically an "upvote" and the extra field just indicates whether it's a downvote

{
  "lexicon": 1,
- "id": "app.bsky.feed.like",
+ "id": "com.henryzoo.feed.vote",
  "defs": {
    "main": {
      "type": "record",
      "description": "Record declaring an upvote or downvote of a piece of subject content.",
      "key": "tid",
      "record": {
        "type": "object",
-       "required": ["subject", "createdAt"],
+       "required": ["subject", "createdAt", "direction"],
        "properties": {
          "subject": { "type": "ref", "ref": "com.atproto.repo.strongRef" },
          "createdAt": { "type": "string", "format": "datetime" },
+         "direction": {
+           "type": "string",
+           "description": "vote direction",
+           "enum": ["up", "down"]
+         }
        }
      }
    }
  }
}

[hzoo]

other projects

• https://threadsky.app - reddit client/thread view for bsky
• https://frontpage.fyi - global reddit-like? separate voting/post lexicon

https://atproto.wiki/en/wiki/sidecar-pattern (had a question about posting to bsky + a custom lexicon at the same time)

[hzoo]

for annotations: was thinking block/channel like on are.na

mark is like an annotation for a ref on atproto

• big q: should you be able to add external urls (or should it be wrapped in like a bookmark lexicon that points to an external url)?
• it needs to go under a "trail" which is essentially a channel/category/list?
• or should it be standalone?
• should allow a note to leave a little comment about it?
• should marks be redundant (like a global, singular mark vs multiple). since you can put the same ref/content/post in multiple trails (example: you find a post and put it under "food" and "nyc")

trails are containers for anything on atproto. it just has a name is how things are indexed?

• how do to shared containers/trails/channels question?
• should there be a canonicial account/did to handle things, etc

{
  "lexicon": 1,
  "id": "ink.henry.feed.mark",
  "defs": {
    "main": {
      "type": "record",
      "description": "An item placed on a trail, referencing content and optionally including a note.",
      "key": "tid",
      "record": {
        "type": "object",
        "required": ["trail", "subject", "createdAt"],
        "properties": {
          "trail": {
            "type": "string",
            "format": "at-uri",
            "description": "A reference to the trail this mark belongs to."
          },
          "subject": {
            "type": "union",
            "description": "The content being marked, either on-protocol or an external link.",
            "refs": ["com.atproto.repo.strongRef", "#externalRef"]
          },
          "note": {
            "type": "string",
            "description": "An optional personal annotation about the marked content.",
            "maxGraphemes": 300,
            "maxLength": 3000
          },
          "createdAt": { "type": "string", "format": "datetime" }
        }
      }
    },
    "externalRef": {
      "type": "object",
      "description": "A reference to an external resource with attached metadata.",
      "required": ["uri"],
      "properties": {
        "uri": { "type": "string", "format": "uri" },
        "title": { "type": "string", "maxLength": 300 },
        "description": { "type": "string", "maxLength": 1000 },
        "thumb": {
          "type": "blob",
          "accept": ["image/png", "image/jpeg"],
          "maxSize": 1000000
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "ink.henry.feed.trail",
  "defs": {
    "main": {
      "type": "record",
      "description": "A curated collection of items. The most basic container for a trail.",
      "key": "tid",
      "record": {
        "type": "object",
        "required": ["name", "createdAt"],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 64,
            "minLength": 1,
            "description": "The display name of the trail."
          },
          "description": {
            "type": "string",
            "maxGraphemes": 300,
            "maxLength": 3000
          },
          "createdAt": { "type": "string", "format": "datetime" }
        }
      }
    }
  }
}