import { procedure } from "../protocol/route-meta.js";
import { ShareCreateSchema, SharedConversationSchema, ShareListSchema, ShareRemoveSchema, ShareUpdateSchema } from "../schemas/share.js";
import { OkSchema } from "../schemas/shared.js";

// Conversations published as read-only pages. Separate from `public`: a share takes a conversation id and renders it,
// `public` copies bytes at a workspace path. No route reads a share back, the page itself is the read, on the
// unauthenticated `public-<slot>` hostname.
export const shareContract = {
    list: procedure
        .route({
            method: "GET",
            path: "/share",
            summary: "Conversations published as pages",
            description:
                "Every conversation that has been turned into a read-only page, with its link. There is no call to read one back: the page itself is the read, and it answers to anyone who has the link.",
        })
        .output(ShareListSchema),
    // Answers with the row it just wrote, link included, so the dialog can show the address without re-listing.
    create: procedure
        .route({
            method: "POST",
            path: "/share",
            summary: "Publish a conversation",
            description:
                "Renders a conversation into a page anybody with the link can read, without signing in. Answers with the link, so nothing has to be listed again to find it.",
        })
        .input(ShareCreateSchema)
        .output(SharedConversationSchema),
    // Re-render an existing share from the conversation as it stands now. Same id, same link, new snapshot.
    update: procedure
        .route({
            method: "POST",
            path: "/share/update",
            summary: "Refresh a published page",
            description: "Re-renders an existing page from the conversation as it stands now. Same link, newer contents.",
        })
        .input(ShareUpdateSchema)
        .output(SharedConversationSchema),
    remove: procedure
        .route({
            method: "POST",
            path: "/share/remove",
            summary: "Unpublish a conversation",
            description: "Takes the page down, so the link stops answering.",
        })
        .input(ShareRemoveSchema)
        .output(OkSchema),
};