Public data

{
  "lexicon": 1,
  "id": "app.bluvy.tube.authFull",
  "defs": {
    "main": {
      "type": "permission-set",
      "title": "Bluvy Tube",
      "title:lang": {
        "fr": "Bluvy Tube"
      },
      "detail": "Bluvy Tube, the video platform for Bluesky, saves your favorites, playlists, app preferences and the details of the videos you publish (title, description, category, chapters, captions) as app.bluvy.tube.* records in your account.",
      "detail:lang": {
        "fr": "Bluvy Tube, la plateforme vidéo pour Bluesky, enregistre vos favoris, vos playlists, vos préférences d'application et les informations des vidéos que vous publiez (titre, description, catégorie, chapitres, sous-titres) sous forme d'enregistrements app.bluvy.tube.* dans votre compte."
      },
      "permissions": [
        {
          "type": "permission",
          "resource": "repo",
          "collection": [
            "app.bluvy.tube.favorite",
            "app.bluvy.tube.playlist",
            "app.bluvy.tube.playlist.item",
            "app.bluvy.tube.video.metadata"
          ],
          "action": ["create", "update", "delete"]
        },
        {
          "type": "permission",
          "resource": "repo",
          "collection": ["app.bluvy.tube.preferences"],
          "action": ["create", "update"]
        }
      ]
    }
  }
}

{
  "lexicon": 1,
  "id": "app.bluvy.tube.favorite",
  "defs": {
    "main": {
      "type": "record",
      "description": "A Bluvy Tube-specific favorite of a video post, written to the favoriting user's own repo. Distinct from any AT Protocol-native bookmark — this is a Bluvy-only concept, source of truth for Bluvy Tube's own 'favorites' feature (not a like or repost). See App\\Controller\\Account\\FavoriteController in the Bluvy Tube source for the writer.",
      "key": "tid",
      "record": {
        "type": "object",
        "required": ["subject", "createdAt"],
        "properties": {
          "subject": {
            "type": "ref",
            "ref": "com.atproto.repo.strongRef",
            "description": "The video post (an app.bsky.feed.post carrying an app.bsky.embed.video) being favorited."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Client-declared timestamp when this favorite was created."
          }
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.bluvy.tube.playlist",
  "defs": {
    "main": {
      "type": "record",
      "description": "A Bluvy Tube playlist — a named, ordered-by-creation collection of videos, written to the owning user's own repo. Membership is tracked separately by app.bluvy.tube.playlist.item records referencing this record via strongRef, the same 'list + separate items' shape as app.bsky.graph.list/listitem. See App\\Controller\\Account\\PlaylistController in the Bluvy Tube source for the writer.",
      "key": "tid",
      "record": {
        "type": "object",
        "required": ["name", "createdAt"],
        "properties": {
          "name": {
            "type": "string",
            "maxGraphemes": 100,
            "maxLength": 300,
            "description": "The playlist's display name."
          },
          "description": {
            "type": "string",
            "maxGraphemes": 500,
            "maxLength": 3000,
            "description": "Optional free-text description of the playlist."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Client-declared timestamp when this playlist was created."
          }
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.bluvy.tube.playlist.item",
  "defs": {
    "main": {
      "type": "record",
      "description": "One video's membership in a app.bluvy.tube.playlist, written to the playlist owner's own repo as a separate record (not embedded in the playlist record itself) — same shape as app.bsky.graph.listitem referencing an app.bsky.graph.list. See App\\Controller\\Account\\PlaylistController in the Bluvy Tube source for the writer.",
      "key": "tid",
      "record": {
        "type": "object",
        "required": ["playlist", "subject", "createdAt"],
        "properties": {
          "playlist": {
            "type": "ref",
            "ref": "com.atproto.repo.strongRef",
            "description": "The app.bluvy.tube.playlist record this item belongs to."
          },
          "subject": {
            "type": "ref",
            "ref": "com.atproto.repo.strongRef",
            "description": "The video post (an app.bsky.feed.post carrying an app.bsky.embed.video) added to the playlist."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Client-declared timestamp when the video was added — also this item's own place in the playlist's display order (oldest first)."
          }
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.bluvy.tube.preferences",
  "defs": {
    "main": {
      "type": "record",
      "description": "Bluvy Tube-specific per-app appearance preferences for one account, written to that account's own repo at rkey `self`. Not required or validated by the PDS or any other AT Protocol app — Bluvy Tube reads this back itself at login to server-render the correct theme and remove the theme flash-of-unstyled-content. Each Bluvy app keeps its own independent record in its own namespace; this one is Bluvy Tube's. See App\\Service\\AppearanceService in the Bluvy Tube source for the writer.",
      "key": "literal:self",
      "record": {
        "type": "object",
        "required": ["mode", "updatedAt"],
        "properties": {
          "mode": {
            "type": "string",
            "enum": ["light", "dark", "system"],
            "description": "Colour-mode axis. 'system' follows the OS prefers-color-scheme."
          },
          "darkStyle": {
            "type": "string",
            "enum": ["dim", "black"],
            "description": "Dark-mode depth. Absent means 'dim' (the default #070D1C ramp); 'black' is the opt-in near-black OLED ramp (#05070D, never pure #000000)."
          },
          "palette": {
            "type": "string",
            "enum": ["bluvy", "bluesky", "blacksky", "mu"],
            "description": "Ecosystem palette. Absent means the Bluvy Tube default palette (logo-derived). The others are opt-in alternates."
          },
          "accent": {
            "type": "string",
            "enum": ["bluvy-blue", "bluvy-cyan", "bluvy-deep"],
            "description": "Logo-derived accent override for primary CTAs. Absent means the Bluvy Blue signature (#185DFF)."
          },
          "fontFamily": {
            "type": "string",
            "enum": ["system", "inter"],
            "description": "UI font family. Absent means the native system stack."
          },
          "fontSize": {
            "type": "string",
            "enum": ["small", "default", "large"],
            "description": "Root text size. Absent means 'default' (100%)."
          },
          "linkAppView": {
            "type": "string",
            "enum": ["bluesky", "mu", "blacksky"],
            "description": "Which AT Protocol AppView web frontend external post/profile links (e.g. 'view original post') open through. Absent means 'mu' (Mu.social, Bluvy Tube's default)."
          },
          "feedMode": {
            "type": "string",
            "enum": ["youtube", "immersive"],
            "description": "Primary feed navigation and video layout mode. 'youtube' is the standard grid of thumbnails; 'immersive' is the continuous full-screen vertical swipe feed. Absent means 'youtube'."
          },
          "breakReminderMinutes": {
            "type": "integer",
            "enum": [15, 30, 45, 60, 90, 120],
            "description": "Wellbeing reminder: minutes of actual playback in vertical swipe feeds before Bluvy Tube interrupts with a take-a-break prompt. Absent means 30. There is intentionally no value that disables the reminder; unknown values are read back as 30."
          },
          "updatedAt": {
            "type": "string",
            "format": "datetime",
            "description": "Client-declared timestamp of the last change."
          }
        }
      }
    }
  }
}

{
  "lexicon": 1,
  "id": "app.bluvy.tube.video.metadata",
  "defs": {
    "main": {
      "type": "record",
      "description": "Bluvy Tube-specific metadata for a published video, written to the creator's own repo alongside the app.bsky.feed.post record that actually carries the video (via app.bsky.embed.video). Not required or validated by the PDS or any other AT Protocol app — Bluvy Tube reads this back itself to render an owner-editable title/description/language overlay on top of the plain post text. Written by App\\Service\\VideoPublicationProcessor (native uploads) and rewritten by App\\Service\\PdsMetadataSyncService on every owner edit, in the Bluvy Tube source.",
      "key": "tid",
      "record": {
        "type": "object",
        "required": ["video", "createdAt"],
        "properties": {
          "video": {
            "type": "blob",
            "accept": ["video/*"],
            "description": "The same video blob referenced by the companion app.bsky.feed.post's app.bsky.embed.video#video."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Client-declared timestamp when this record was created."
          },
          "title": {
            "type": "string",
            "maxGraphemes": 300,
            "maxLength": 3000,
            "description": "Owner-editable title, shown on Bluvy Tube in place of the raw post text."
          },
          "description": {
            "type": "string",
            "maxGraphemes": 3000,
            "maxLength": 30000
          },
          "language": {
            "type": "string",
            "description": "BCP-47 language tag for the video's primary spoken/subtitle language."
          },
          "category": {
            "type": "string",
            "description": "Primary category slug (e.g. 'gaming', 'tech', 'music', etc.)."
          },
          "secondaryCategories": {
            "type": "array",
            "items": { "type": "string" },
            "description": "Optional secondary category slugs."
          },
          "postUri": {
            "type": "string",
            "format": "at-uri",
            "description": "The at-uri of the companion app.bsky.feed.post record, set once that record has been created (this metadata record is written first, in a two-step publish)."
          },
          "postCid": {
            "type": "string",
            "format": "cid",
            "description": "The CID of the companion app.bsky.feed.post record as of the last write of this record; together with postUri, a strong reference to it. Set together with postUri."
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The Bluvy Tube web page that renders this video (a stable https://{host}/at/{did}/app.bsky.feed.post/{rkey} address). Attests the page in the record-to-page direction; the page links back via an at:canonical meta tag. Set together with postUri."
          },
          "duration": {
            "type": "integer",
            "description": "Duration of the video in seconds."
          },
          "thumbnail": {
            "type": "blob",
            "accept": ["image/jpeg"],
            "maxSize": 2000000,
            "description": "A thumbnail the owner chose for this video (at most 1280 px on each side). Bluvy Tube shows it instead of the frame generated by the video service; the companion post keeps the generated one."
          },
          "isAiGenerated": {
            "type": "boolean",
            "description": "Whether the video content was generated by AI."
          },
          "chapters": {
            "type": "array",
            "maxLength": 50,
            "description": "Owner-editable chapter markers shown on Bluvy Tube's scrubber.",
            "items": {
              "type": "object",
              "required": ["title", "startTimeSeconds"],
              "properties": {
                "title": {
                  "type": "string",
                  "maxGraphemes": 100,
                  "maxLength": 500
                },
                "startTimeSeconds": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          },
          "captions": {
            "type": "array",
            "maxLength": 20,
            "description": "Owner-uploaded WebVTT subtitle/caption tracks, one per language.",
            "items": {
              "type": "object",
              "required": ["lang", "vtt"],
              "properties": {
                "lang": {
                  "type": "string",
                  "description": "BCP-47 language tag for this track, e.g. 'fr' or 'en-US'."
                },
                "vtt": {
                  "type": "blob",
                  "accept": ["text/vtt"],
                  "description": "WebVTT subtitle/caption file for this language."
                }
              }
            }
          }
        }
      }
    }
  }
}