-- 0014_documents: 文档存储元数据（design/24 §3.2 / §3.3 / §6.1，切片 S1）。
--
-- 一行 = 一份内容寻址落盘的文档。落盘名 name = sha256(bytes)[:32] + ext，
-- 因此「同字节同扩展名」必然同名 —— 去重是内容寻址的自然结果，本表只负责
-- 记账（谁传的、多大、什么类型、什么时候），不参与去重判定。
--
-- 为什么必须有这张表：文件系统只回答「文件在不在」，回答不了「这份文档是谁
-- 传的、最后一次被消息引用是什么时候」。切片 S7 的引用计数与 GC（未被任何
-- 消息引用且超过保留期者删除）据此工作，因此本表从一开始就留足列；S1 只写。
--
-- 口径：
--   - name 唯一索引承载 ON CONFLICT(name) DO NOTHING（重复上传不刷新首次记录）；
--   - mime 是**服务端字节嗅探所得**的基类型，不是客户端声明的 Content-Type；
--   - size 是落盘字节数；uploader 是 JWT sub，取不到时为 'anonymous'；
--   - last_referenced_at / ref_count 由 S7 维护，此处只建列（S1 不填）。
-- 表名用复数，援引 AGENTS §10 已登记的例外（既有迁移口径一致）。
CREATE TABLE IF NOT EXISTS documents (
    id                 INTEGER PRIMARY KEY AUTOINCREMENT,
    name               TEXT    NOT NULL,
    sha256             TEXT    NOT NULL,
    mime               TEXT    NOT NULL,
    size               INTEGER NOT NULL,
    uploader           TEXT    NOT NULL DEFAULT '',
    created_at         TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ','now')),
    last_referenced_at TEXT,
    ref_count          INTEGER NOT NULL DEFAULT 0
);

-- 唯一索引同时承担 upsert 的冲突目标（ON CONFLICT(name) 需要唯一约束/索引）。
CREATE UNIQUE INDEX IF NOT EXISTS idx_documents_name
    ON documents (name);

-- 按内容哈希查找（同字节不同扩展名时也想知道「这份内容还存着哪些名字」）。
CREATE INDEX IF NOT EXISTS idx_documents_sha256
    ON documents (sha256);