@songsid/agend 2.3.5-alpha.4 → 2.3.5-alpha.5

package/dist/hub/retention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.js","sourceRoot":"","sources":["../../src/hub/retention.ts"],"names":[],"mappings":"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"}

package/dist/hub/rooms.d.ts

@@ -0,0 +1,120 @@
+import { HubButtonsService } from "./buttons.js";
+import type { HubAttachmentChunk } from "./types.js";
+import type { HubAnswer, HubExposure, HubReceipt, HubReconcile, HubReconcileReply, HubRequestContext, HubRoom, HubRoomEntry } from "./types.js";
+import type { HubLinkContext } from "./server.js";
+import { type HubPolicyService } from "./policy.js";
+import { type HubCore } from "./http/core.js";
+/** One accepted poll per room and session in this window (hub.md §5: at most once per ten seconds). */
+export declare const ROOM_POLL_MS = 10000;
+/** A room as the conversation list shows it (#3226 B). */
+export interface HubRoomListItem extends HubRoom {
+    exposureName: string;
+    exposureState: HubExposure["state"];
+    ownerName: string;
+    grantExpiresAt: number;
+    lastAt: number;
+    waiting: boolean;
+    features: readonly string[];
+}
+/** A file as the asker's browser sees it: always fetched through the room's own route. */
+export interface HubFileView {
+    id: string;
+    name: string;
+    size: number;
+    mime: string;
+    url: string;
+}
+export interface HubRoomEntryView extends HubRoomEntry {
+    buttons?: import("../reply-buttons-controller.js").ReplyButtonsView;
+    expired?: boolean;
+    questionFiles?: HubFileView[];
+    answerFiles?: HubFileView[];
+}
+export declare class HubRoomsService {
+    private readonly core;
+    private readonly policy;
+    /** The newest link seen per fleet (from S1's receive): dispatch uses it only while it is current. */
+    private readonly links;
+    private readonly polls;
+    private readonly flushing;
+    readonly buttons: HubButtonsService;
+    constructor(core: HubCore, policy: HubPolicyService);
+    noteLink(link: HubLinkContext): void;
+    forget(): void;
+    private store;
+    /** The optional features of a fleet's current link (empty while it has none: nothing new is offered or sent). */
+    features(fleetId: string): readonly string[];
+    private requireFiles;
+    /** The asker's room, its grant applying now with `permission`, inside a transaction. */
+    private askerRoom;
+    private ownerEligible;
+    /** Before any upload body is read: the asker, their room and grant, a link that takes files, and room in their budget. */
+    uploadAdmit(ctx: HubRequestContext, roomId: string, declaredBytes: number): Promise<void>;
+    /** The asker's file for a later question in this room: only while the fleet's link takes files. Pending one hour. */
+    upload(ctx: HubRequestContext, roomId: string, name: string, bytes: Buffer): Promise<HubFileView>;
+    /** One of this room's files, for its asker while read-own-room holds; every read is audited. */
+    download(ctx: HubRequestContext, roomId: string, fileId: string): Promise<{
+        name: string;
+        mime: string;
+        image: boolean;
+        bytes: Buffer;
+    }>;
+    /** Open (or find) the asker's room for one exposure under one grant that applies to them now. */
+    open(ctx: HubRequestContext, exposureId: string, grantId: string): Promise<HubRoom & {
+        exposure: HubExposure;
+    }>;
+    /**
+     * This person's rooms, the most recently active first, as the chat's conversation list draws them (#3226 B): the
+     * exposure's name and state, who it represents (the owner's display name), the grant's end, when the room last moved
+     * and whether a question there still waits for its answer, and what its fleet link negotiated (`features`). A closed room (its grant revoked, its agent withdrawn) is
+     * listed too, as closed: the person keeps knowing which chat it was (its history is not readable any more). `features`: what the room's fleet link
+     * has negotiated (D's link.features; none until then).
+     */
+    list(ctx: HubRequestContext): Promise<readonly HubRoomListItem[]>;
+    /**
+     * #3226 C (the user's choice): who asked one of the owner's agents, when, and how it went — never what was asked or
+     * answered. The owner only (another person: not-found); the latest 20; the read is audited like any metadata read.
+     */
+    activity(ctx: HubRequestContext, exposureId: string): Promise<readonly {
+        askerName: string;
+        askedAt: number;
+        stage: HubReceipt["stage"];
+    }[]>;
+    /**
+     * One room as `list` draws it — its asker only, else not-found (checked here, not left to the caller: the messages
+     * route asks it after its own read, but this answers alone). The messages answer carries it, fresh each poll.
+     */
+    view(ctx: HubRequestContext, roomId: string): Promise<HubRoomListItem>;
+    /** What the room's fleet link negotiated (D's link.features, #3241): none while it has no current link. */
+    private featuresOf;
+    /** Ask in a room: committed with its audit before "queued" is reported; then sent if the member is on. */
+    ask(ctx: HubRequestContext, roomId: string, idempotencyKey: string, text: string, fileIds?: readonly string[]): Promise<HubReceipt>;
+    /** One queue/receipt/audit path for typed asks, button clicks and authorized automatic poll results. */
+    private insertQuestion;
+    /** The room's entries after `after`, for its asker only — both people and the grant re-checked; paced per session. */
+    read(ctx: HubRequestContext, roomId: string, after: number, sessionKey: string): Promise<readonly HubRoomEntryView[]>;
+    /**
+     * Send this fleet's queued questions over its current, reconciled link (one flush at a time per fleet). Questions
+     * whose facts no longer hold are cancelled. Expired ones fail. Without a transport or a current link nothing moves.
+     */
+    /** Resolves false when a send was refused (the link not ready yet, or gone): the caller may try again shortly. */
+    flush(fleetId: string): Promise<boolean>;
+    /** A member's receipt: its own durable evidence for one of the messages sent to it. Echoed back as the ACK. */
+    receipt(r: HubReceipt, link: HubLinkContext): HubReceipt;
+    /** A member's final answer, accepted only under the Hub's own release lease for exactly it, authorization still holding. */
+    answer(a: HubAnswer, link: HubLinkContext): Promise<HubReceipt>;
+    /** attachments-v1: the member pulls one chunk of a file of a question sent to its fleet (in order, one in flight).
+     * Every chunk is a disclosure: both people eligible now, the current link, and the message's room/grant/exposure facts
+     * (messageFacts, as for sending) re-checked at the moment the bytes are read — a revoked grant stops the next chunk. */
+    attachmentGet(input: {
+        id: string;
+        offset: number;
+    }, link: HubLinkContext): Promise<HubAttachmentChunk>;
+    /** attachments-v1: one chunk of an answer's file from the member, before the answer that names it. */
+    attachmentPut(input: HubAttachmentChunk, link: HubLinkContext): {
+        id: string;
+        offset: number;
+    };
+    /** The member's reconcile page: the retained receipts after its cursor (the Hub's ACKs), at most 128 per page. */
+    reconcile(input: HubReconcile, link: HubLinkContext): HubReconcileReply;
+}