Arsse/sql/SQLite3/0.sql

-- settings
create table arsse_settings(
    key varchar(255) primary key not null,                                                                  -- setting key
    value varchar(255),                                                                                     -- setting value, serialized as a string
    type varchar(255) not null check(
        type in('int','numeric','text','timestamp','date','time','bool','null','json')
    ) default 'text'                                                                                        -- the deserialized type of the value
) without rowid;

-- users
create table arsse_users(
    id TEXT primary key not null,                                                                           -- user id
    password TEXT,                                                                                          -- password, salted and hashed; if using external authentication this would be blank
    name TEXT,                                                                                              -- display name
    avatar_url TEXT,                                                                                        -- external URL to avatar
    avatar_type TEXT,                                                                                       -- internal avatar image's MIME content type
    avatar_data BLOB,                                                                                       -- internal avatar image's binary data
    rights integer not null default 0                                                                       -- any administrative rights the user may have
) without rowid;

-- newsfeeds, deduplicated
create table arsse_feeds(
    id integer primary key,                                                                                 -- sequence number
    url TEXT not null,                                                                                      -- URL of feed
    title TEXT,                                                                                             -- default title of feed
    favicon TEXT,                                                                                           -- URL of favicon
    source TEXT,                                                                                            -- URL of site to which the feed belongs
    updated datetime,                                                                                       -- time at which the feed was last fetched
    modified datetime,                                                                                      -- time at which the feed last actually changed
    next_fetch datetime,                                                                                    -- time at which the feed should next be fetched
    etag TEXT not null default '',                                                                          -- HTTP ETag hash used for cache validation, changes each time the content changes
    err_count integer not null default 0,                                                                   -- count of successive times update resulted in error since last successful update
    err_msg TEXT,                                                                                           -- last error message
    username TEXT not null default '',                                                                      -- HTTP authentication username
    password TEXT not null default '',                                                                      -- HTTP authentication password (this is stored in plain text)
    unique(url,username,password)                                                                           -- a URL with particular credentials should only appear once
);

-- users' subscriptions to newsfeeds, with settings
create table arsse_subscriptions(
    id integer primary key,                                                                                 -- sequence number
    owner TEXT not null references arsse_users(id) on delete cascade on update cascade,                     -- owner of subscription
    feed integer not null references arsse_feeds(id) on delete cascade,                                     -- feed for the subscription
    added datetime not null default CURRENT_TIMESTAMP,                                                      -- time at which feed was added
    modified datetime not null default CURRENT_TIMESTAMP,                                                   -- date at which subscription properties were last modified
    title TEXT,                                                                                             -- user-supplied title
    order_type int not null default 0,                                                                      -- NextCloud sort order
    pinned boolean not null default 0,                                                                      -- whether feed is pinned (always sorts at top)
    folder integer references arsse_folders(id) on delete cascade,                                          -- TT-RSS category (nestable); the first-level category (which acts as NextCloud folder) is joined in when needed
    unique(owner,feed)                                                                                      -- a given feed should only appear once for a given owner
);

-- TT-RSS categories and NextCloud folders
create table arsse_folders(
    id integer primary key,                                                                                 -- sequence number
    owner TEXT not null references arsse_users(id) on delete cascade on update cascade,                     -- owner of folder
    parent integer references arsse_folders(id) on delete cascade,                                          -- parent folder id
    name TEXT not null,                                                                                     -- folder name
    modified datetime not null default CURRENT_TIMESTAMP,                                                   --
    unique(owner,name,parent)                                                                               -- cannot have multiple folders with the same name under the same parent for the same owner
);

-- entries in newsfeeds
create table arsse_articles(
    id integer primary key,                                                                                 -- sequence number
    feed integer not null references arsse_feeds(id) on delete cascade,                                     -- feed for the subscription
    url TEXT,                                                                                               -- URL of article
    title TEXT,                                                                                             -- article title
    author TEXT,                                                                                            -- author's name
    published datetime,                                                                                     -- time of original publication
    edited datetime,                                                                                        -- time of last edit
    modified datetime not null default CURRENT_TIMESTAMP,                                                   -- date when article properties were last modified
    guid TEXT,                                                                                              -- GUID
    content TEXT,                                                                                           -- content, as (X)HTML
    url_title_hash TEXT not null,                                                                           -- hash of URL + title; used when checking for updates and for identification if there is no guid.
    url_content_hash TEXT not null,                                                                         -- hash of URL + content, enclosure URL, & content type; used when checking for updates and for identification if there is no guid.
    title_content_hash TEXT not null                                                                        -- hash of title + content, enclosure URL, & content type; used when checking for updates and for identification if there is no guid.
);

-- enclosures associated with articles
create table arsse_enclosures(
    article integer not null references arsse_articles(id) on delete cascade,
    url TEXT,
    type varchar(255)
);

-- users' actions on newsfeed entries
create table arsse_marks(
    id integer primary key,
    article integer not null references arsse_articles(id) on delete cascade,
    owner TEXT not null references arsse_users(id) on delete cascade on update cascade,
    read boolean not null default 0,
    starred boolean not null default 0,
    modified datetime not null default CURRENT_TIMESTAMP,
    unique(article,owner)
);

-- IDs for specific editions of articles (required for at least NextCloud News)
create table arsse_editions(
    id integer primary key,
    article integer not null references arsse_articles(id) on delete cascade,
    modified datetime not null default CURRENT_TIMESTAMP
);

-- user labels associated with newsfeed entries
create table arsse_labels(
    sub_article integer not null references arsse_subscription_articles(id) on delete cascade,
    name TEXT
);
create index arsse_label_names on arsse_labels(name);

-- author categories associated with newsfeed entries
create table arsse_categories(
    article integer not null references arsse_articles(id) on delete cascade,
    name TEXT
);

-- set version marker
pragma user_version = 1;
insert into arsse_settings values('schema_version',1,'int');