Feed Reader

manifest.json 386 lines

Files · 10
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386{
  "id": "com.lattice.feeds",
  "name": "Feed Reader",
  "icon": "📰",
  "color": "#2563eb",
  "description": "Subscribe to RSS and Atom feeds and read saved items. Feed addresses are stored as https; http addresses are upgraded when subscribing. Workflows can identify subscriptions by title or URL; RSS source fields identify where an article was first published.",
  "provenance": "RSS 2.0 item model, verified 2026-10-14: https://www.rssboard.org/rss-specification#hrelementsOfLtitemgt . Adopted title, link, description, author, category, comments, guid, pubDate -> pub_date, source, plus guid@isPermaLink -> guid_is_perma_link, source@url -> source_url and enclosure@url/length/type -> enclosure_url/enclosure_length/enclosure_type. The fixture selects one category and one enclosure per item; XML attributes are flattened and boolean isPermaLink uses SQLite 0/1. id is a local surrogate. RFC 822 dates and opaque GUIDs are retained. RSS is the independently specified feed format, not an API of a particular reader; local events/listeners are fixture actions.",
  "requested_permissions": {
    "storage": ["sql"],
    "network": {
      "allowlist": [],
      "user_sites": true
    },
    "events": {
      "item-received": {
        "description": "A new feed item was received.",
        "schema": {
          "type": "object",
          "properties": {
            "feed_id": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Subscription ID referencing feeds.id; null for standalone or file-imported items."
            },
            "feed_title": {
              "type": [
                "string",
                "null"
              ],
              "description": "Subscription title as shown in the reader (feeds.title); null for standalone or file-imported items."
            },
            "feed_url": {
              "type": ["string", "null"],
              "description": "Subscription address as stored in feeds.url. Feed Reader stores feed addresses as https and upgrades an http address when subscribing; null for standalone or file-imported items."
            },
            "id": {
              "type": "integer",
              "description": "Feed item ID."
            },
            "guid": {
              "type": ["string", "null"],
              "description": "Opaque RSS identifier, possibly a URL; null means unspecified."
            },
            "guid_is_perma_link": {
              "type": "integer",
              "description": "GUID permalink flag: 0=false, 1=true.",
              "enum": [0, 1]
            },
            "title": {
              "type": ["string", "null"],
              "description": "Item title; null when only synopsis is supplied."
            },
            "link": {
              "type": ["string", "null"],
              "description": "Original item URL; null means unspecified."
            },
            "description": {
              "type": ["string", "null"],
              "description": "Item synopsis, possibly HTML; null means unspecified."
            },
            "author": {
              "type": ["string", "null"],
              "description": "Author email address, optionally with display name; null means unspecified."
            },
            "category": {
              "type": ["string", "null"],
              "description": "Single category path; null means unspecified."
            },
            "comments": {
              "type": ["string", "null"],
              "description": "Comments page URL; null means unspecified."
            },
            "pub_date": {
              "type": ["string", "null"],
              "description": "Publication timestamp, RFC 822; null means unspecified."
            },
            "source": {
              "type": ["string", "null"],
              "description": "RSS <source> element: name of the channel where the item was first published, not the subscription; null means unspecified."
            },
            "source_url": {
              "type": ["string", "null"],
              "description": "RSS <source> element URL: feed where the item was first published, not the subscription URL; null means unspecified."
            },
            "enclosure_url": {
              "type": ["string", "null"],
              "description": "Attached media URL; null means unspecified."
            },
            "enclosure_length": {
              "type": ["integer", "null"],
              "description": "Attached media size in bytes; null means unspecified.",
              "minimum": 0
            },
            "enclosure_type": {
              "type": ["string", "null"],
              "description": "Attached media MIME type; null means unspecified."
            }
          },
          "required": ["id", "feed_id", "feed_title", "feed_url"],
          "additionalProperties": false,
          "anyOf": [
            {
              "required": ["title"],
              "properties": {
                "title": {
                  "type": "string"
                }
              }
            },
            {
              "required": ["description"],
              "properties": {
                "description": {
                  "type": "string"
                }
              }
            }
          ]
        }
      },
      "item-updated": {
        "description": "An existing feed item was updated.",
        "schema": {
          "type": "object",
          "properties": {
            "feed_id": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Subscription ID referencing feeds.id; null for standalone or file-imported items."
            },
            "feed_title": {
              "type": [
                "string",
                "null"
              ],
              "description": "Subscription title as shown in the reader (feeds.title); null for standalone or file-imported items."
            },
            "feed_url": {
              "type": ["string", "null"],
              "description": "Subscription address as stored in feeds.url. Feed Reader stores feed addresses as https and upgrades an http address when subscribing; null for standalone or file-imported items."
            },
            "id": {
              "type": "integer",
              "description": "Feed item ID."
            },
            "guid": {
              "type": ["string", "null"],
              "description": "Opaque RSS identifier, possibly a URL; null means unspecified."
            },
            "guid_is_perma_link": {
              "type": "integer",
              "description": "GUID permalink flag: 0=false, 1=true.",
              "enum": [0, 1]
            },
            "title": {
              "type": ["string", "null"],
              "description": "Item title; null when only synopsis is supplied."
            },
            "link": {
              "type": ["string", "null"],
              "description": "Original item URL; null means unspecified."
            },
            "description": {
              "type": ["string", "null"],
              "description": "Item synopsis, possibly HTML; null means unspecified."
            },
            "author": {
              "type": ["string", "null"],
              "description": "Author email address, optionally with display name; null means unspecified."
            },
            "category": {
              "type": ["string", "null"],
              "description": "Single category path; null means unspecified."
            },
            "comments": {
              "type": ["string", "null"],
              "description": "Comments page URL; null means unspecified."
            },
            "pub_date": {
              "type": ["string", "null"],
              "description": "Publication timestamp, RFC 822; null means unspecified."
            },
            "source": {
              "type": ["string", "null"],
              "description": "RSS <source> element: name of the channel where the item was first published, not the subscription; null means unspecified."
            },
            "source_url": {
              "type": ["string", "null"],
              "description": "RSS <source> element URL: feed where the item was first published, not the subscription URL; null means unspecified."
            },
            "enclosure_url": {
              "type": ["string", "null"],
              "description": "Attached media URL; null means unspecified."
            },
            "enclosure_length": {
              "type": ["integer", "null"],
              "description": "Attached media size in bytes; null means unspecified.",
              "minimum": 0
            },
            "enclosure_type": {
              "type": ["string", "null"],
              "description": "Attached media MIME type; null means unspecified."
            }
          },
          "required": ["id", "feed_id", "feed_title", "feed_url"],
          "additionalProperties": false,
          "anyOf": [
            {
              "required": ["title"],
              "properties": {
                "title": {
                  "type": "string"
                }
              }
            },
            {
              "required": ["description"],
              "properties": {
                "description": {
                  "type": "string"
                }
              }
            }
          ]
        }
      },
      "item-opened": {
        "description": "A feed item or its original link was opened.",
        "schema": {
          "type": "object",
          "properties": {
            "feed_id": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Subscription ID referencing feeds.id; null for standalone or file-imported items."
            },
            "feed_title": {
              "type": [
                "string",
                "null"
              ],
              "description": "Subscription title as shown in the reader (feeds.title); null for standalone or file-imported items."
            },
            "feed_url": {
              "type": ["string", "null"],
              "description": "Subscription address as stored in feeds.url. Feed Reader stores feed addresses as https and upgrades an http address when subscribing; null for standalone or file-imported items."
            },
            "id": {
              "type": "integer",
              "description": "Feed item ID."
            },
            "guid": {
              "type": ["string", "null"],
              "description": "Opaque RSS identifier, possibly a URL; null means unspecified."
            },
            "title": {
              "type": ["string", "null"],
              "description": "Item title; null when only synopsis is supplied."
            },
            "link": {
              "type": ["string", "null"],
              "description": "Original item URL; null means unspecified."
            },
            "pub_date": {
              "type": ["string", "null"],
              "description": "Publication timestamp, RFC 822; null means unspecified."
            }
          },
          "required": ["id", "feed_id", "feed_title", "feed_url"],
          "additionalProperties": false
        }
      }
    },
    "listeners": {
      "receive-item": {
        "description": "Import a feed item with a title or synopsis.",
        "schema": {
          "type": "object",
          "properties": {
            "feed_id": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Subscription ID referencing feeds.id; null for standalone or file-imported items."
            },
            "id": {
              "type": "integer",
              "description": "Feed item ID; generated when omitted."
            },
            "guid": {
              "type": ["string", "null"],
              "description": "Opaque RSS identifier, possibly a URL; omitted or null means unspecified."
            },
            "guid_is_perma_link": {
              "type": "integer",
              "description": "GUID permalink flag: 0=false, 1=true; omitted defaults to 1.",
              "enum": [0, 1]
            },
            "title": {
              "type": ["string", "null"],
              "description": "Item title; omitted or null when synopsis is supplied."
            },
            "link": {
              "type": ["string", "null"],
              "description": "Original item URL; omitted or null means unspecified."
            },
            "description": {
              "type": ["string", "null"],
              "description": "Item synopsis, possibly HTML; omitted or null means unspecified."
            },
            "author": {
              "type": ["string", "null"],
              "description": "Author email address, optionally with display name; omitted or null means unspecified."
            },
            "category": {
              "type": ["string", "null"],
              "description": "Single category path; omitted or null means unspecified."
            },
            "comments": {
              "type": ["string", "null"],
              "description": "Comments page URL; omitted or null means unspecified."
            },
            "pub_date": {
              "type": ["string", "null"],
              "description": "Publication timestamp, RFC 822; omitted or null means unspecified."
            },
            "source": {
              "type": ["string", "null"],
              "description": "RSS <source> element: name of the channel where the item was first published, not the subscription; null means unspecified."
            },
            "source_url": {
              "type": ["string", "null"],
              "description": "RSS <source> element URL: feed where the item was first published, not the subscription URL; null means unspecified."
            },
            "enclosure_url": {
              "type": ["string", "null"],
              "description": "Attached media URL; omitted or null means unspecified."
            },
            "enclosure_length": {
              "type": ["integer", "null"],
              "description": "Attached media size in bytes; omitted or null means unspecified.",
              "minimum": 0
            },
            "enclosure_type": {
              "type": ["string", "null"],
              "description": "Attached media MIME type; omitted or null means unspecified."
            }
          },
          "required": [],
          "additionalProperties": false,
          "anyOf": [
            {
              "required": ["title"],
              "properties": {
                "title": {
                  "type": "string"
                }
              }
            },
            {
              "required": ["description"],
              "properties": {
                "description": {
                  "type": "string"
                }
              }
            }
          ]
        }
      }
    }
  },
  "x-effects": {
    "receive-item": {
      "table": "items",
      "emits": "item-received"
    }
  }
}