@polymorfa/browser 0.1.0-dev.20260922094209

package/dist/chat/composer.js

@@ -0,0 +1,217 @@
+import { ObservableController, } from "../controller.js";
+/** Describe a picked, pasted, or dropped file as a composer attachment. */
+export function localAttachmentFromFile(file, createId = () => crypto.randomUUID()) {
+    return {
+        id: createId(),
+        name: file.name,
+        size: file.size,
+        contentType: file.type === "" ? "application/octet-stream" : file.type,
+        file,
+    };
+}
+/**
+ * Composer actions that send through a conversation, so the composer and the
+ * message list share one optimistic history. `upload` stays yours: it turns
+ * the local bytes into a hosted `MessageAttachment`.
+ */
+export function createConversationComposerActions(conversation, upload) {
+    return {
+        upload,
+        send: (draft, signal) => conversation.send({
+            text: draft.text,
+            ...(draft.replyTo === undefined ? {} : { replyTo: draft.replyTo }),
+            ...(draft.attachments.length === 0
+                ? {}
+                : { attachments: draft.attachments }),
+        }, signal),
+    };
+}
+export class MessageComposerController extends ObservableController {
+    #actions;
+    #maxTextLength;
+    #maxAttachmentSize;
+    #uploads = new Map();
+    #sendAbort;
+    constructor(actions, options = {}) {
+        super({ status: "ready", text: "", attachments: [], sending: false }, options.now);
+        this.#actions = actions;
+        this.#maxTextLength = options.maxTextLength ?? 4096;
+        this.#maxAttachmentSize = options.maxAttachmentSize ?? 25 * 1024 * 1024;
+    }
+    setText(text) {
+        this.#update({ text });
+    }
+    setReplyTo(replyTo) {
+        this.#update(replyTo === undefined ? { clearReply: true } : { replyTo });
+    }
+    async addAttachment(attachment) {
+        this.assertActive();
+        if (attachment.size > this.#maxAttachmentSize)
+            throw new Error(`Attachment exceeds ${this.#maxAttachmentSize} bytes.`);
+        if (this.getSnapshot().attachments.some(({ id }) => id === attachment.id))
+            return;
+        const abort = new AbortController();
+        this.#uploads.set(attachment.id, abort);
+        this.#replaceAttachment({
+            ...attachment,
+            status: "uploading",
+            progress: 0,
+        });
+        try {
+            const uploaded = await this.#actions.upload(attachment, (progress) => this.#progress(attachment.id, progress), abort.signal);
+            if (!abort.signal.aborted)
+                this.#replaceAttachment({
+                    ...attachment,
+                    status: "ready",
+                    progress: 1,
+                    uploaded,
+                });
+        }
+        catch (cause) {
+            if (!abort.signal.aborted)
+                this.#replaceAttachment({
+                    ...attachment,
+                    status: "failed",
+                    progress: 0,
+                    error: errorMessage(cause),
+                });
+        }
+        finally {
+            this.#uploads.delete(attachment.id);
+        }
+    }
+    cancelAttachment(id) {
+        this.#uploads.get(id)?.abort();
+        this.#uploads.delete(id);
+        const current = this.getSnapshot();
+        this.transition({
+            ...composerFields(current),
+            attachments: current.attachments.filter((item) => item.id !== id),
+        });
+    }
+    async submit() {
+        const current = this.getSnapshot();
+        if (current.sending)
+            throw new Error("Composer is already sending.");
+        if (current.text.length > this.#maxTextLength)
+            this.#rejectSubmit(current, `Message text cannot exceed ${this.#maxTextLength} characters.`);
+        if (current.attachments.some(({ status }) => status !== "ready"))
+            this.#rejectSubmit(current, "Attachments must finish uploading before send.");
+        if (current.text.trim() === "" && current.attachments.length === 0)
+            throw new Error("Message cannot be empty.");
+        const abort = new AbortController();
+        this.#sendAbort = abort;
+        this.transition({ ...composerFields(current), sending: true });
+        try {
+            await this.#actions.send({
+                text: current.text,
+                ...(current.replyTo === undefined
+                    ? {}
+                    : { replyTo: current.replyTo }),
+                attachments: current.attachments.flatMap(({ uploaded }) => uploaded === undefined ? [] : [uploaded]),
+            }, abort.signal);
+            if (!abort.signal.aborted)
+                this.reset();
+        }
+        catch (cause) {
+            if (!abort.signal.aborted)
+                this.transition({
+                    ...composerFields(current),
+                    status: "error",
+                    sending: false,
+                    error: errorMessage(cause),
+                });
+        }
+        finally {
+            if (this.#sendAbort === abort)
+                this.#sendAbort = undefined;
+        }
+    }
+    /** Publish a validation failure so bound UI can show it, then reject. */
+    #rejectSubmit(current, message) {
+        this.transition({
+            ...composerFields(current),
+            status: "error",
+            error: message,
+        });
+        throw new Error(message);
+    }
+    cancelSend() {
+        this.#sendAbort?.abort();
+        this.#sendAbort = undefined;
+        const current = this.getSnapshot();
+        this.transition({ ...composerFields(current), sending: false });
+    }
+    reset() {
+        for (const upload of this.#uploads.values())
+            upload.abort();
+        this.#uploads.clear();
+        this.transition({
+            status: "ready",
+            text: "",
+            attachments: [],
+            sending: false,
+        });
+    }
+    onDispose() {
+        for (const upload of this.#uploads.values())
+            upload.abort();
+        this.#uploads.clear();
+        this.#sendAbort?.abort();
+    }
+    #update(change) {
+        const current = this.getSnapshot();
+        const base = {
+            status: "ready",
+            text: change.text ?? current.text,
+            attachments: current.attachments,
+            sending: current.sending,
+            ...(current.error === undefined ? {} : { error: current.error }),
+        };
+        this.transition({
+            ...base,
+            ...(change.clearReply
+                ? {}
+                : change.replyTo === undefined
+                    ? current.replyTo === undefined
+                        ? {}
+                        : { replyTo: current.replyTo }
+                    : { replyTo: change.replyTo }),
+        });
+    }
+    #progress(id, progress) {
+        const current = this.getSnapshot();
+        if (!this.#uploads.has(id))
+            return;
+        this.transition({
+            ...composerFields(current),
+            attachments: current.attachments.map((item) => item.id === id
+                ? { ...item, progress: Math.max(0, Math.min(progress, 1)) }
+                : item),
+        });
+    }
+    #replaceAttachment(attachment) {
+        const current = this.getSnapshot();
+        const existing = current.attachments.some(({ id }) => id === attachment.id);
+        this.transition({
+            ...composerFields(current),
+            attachments: existing
+                ? current.attachments.map((item) => item.id === attachment.id ? attachment : item)
+                : [...current.attachments, attachment],
+        });
+    }
+}
+function composerFields(snapshot) {
+    return {
+        status: snapshot.status,
+        text: snapshot.text,
+        attachments: snapshot.attachments,
+        sending: snapshot.sending,
+        ...(snapshot.replyTo === undefined ? {} : { replyTo: snapshot.replyTo }),
+        ...(snapshot.error === undefined ? {} : { error: snapshot.error }),
+    };
+}
+function errorMessage(cause) {
+    return cause instanceof Error ? cause.message : "Composer request failed.";
+}
+//# sourceMappingURL=composer.js.map

package/dist/chat/composer.js.map

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

package/dist/chat/conversation.d.ts

@@ -0,0 +1,71 @@
+import { ObservableController, type ControllerSnapshot } from "../controller.js";
+export type MessageDirection = "inbound" | "outbound";
+export type MessageStatus = "pending" | "sent" | "failed";
+export interface MessageAttachment {
+    readonly id: string;
+    readonly name: string;
+    readonly size: number;
+    readonly contentType: string;
+    /** Where the full file can be opened or downloaded. */
+    readonly url?: string;
+    /** A smaller image to show inline; falls back to `url` for images. */
+    readonly previewUrl?: string;
+}
+export interface ConversationMessage {
+    readonly id: string;
+    readonly clientId?: string;
+    readonly text: string;
+    readonly createdAt: number;
+    readonly direction: MessageDirection;
+    readonly status: MessageStatus;
+    readonly replyTo?: string;
+    readonly attachments?: readonly MessageAttachment[];
+    readonly error?: string;
+}
+export interface OutgoingMessage {
+    readonly clientId: string;
+    readonly text: string;
+    readonly replyTo?: string;
+    readonly attachments?: readonly MessageAttachment[];
+}
+export interface ConversationPage {
+    readonly messages: readonly ConversationMessage[];
+    readonly nextCursor?: string;
+}
+export type ConversationEvent = {
+    readonly type: "upsert";
+    readonly message: ConversationMessage;
+} | {
+    readonly type: "delete";
+    readonly messageId: string;
+};
+export interface ConversationDataSource {
+    load(cursor?: string, signal?: AbortSignal): Promise<ConversationPage>;
+    subscribe(listener: (event: ConversationEvent) => void): () => void;
+    send(message: OutgoingMessage, signal?: AbortSignal): Promise<ConversationMessage>;
+}
+export interface ConversationSnapshot extends ControllerSnapshot {
+    readonly status: "idle" | "loading" | "ready" | "loading_more" | "error";
+    readonly messages: readonly ConversationMessage[];
+    readonly hasMore: boolean;
+    readonly cursor?: string;
+    readonly error?: string;
+}
+export interface ConversationControllerOptions {
+    readonly createClientId?: () => string;
+    readonly now?: () => number;
+}
+export declare class ConversationController extends ObservableController<ConversationSnapshot> {
+    #private;
+    constructor(source: ConversationDataSource, options?: ConversationControllerOptions);
+    load(): Promise<void>;
+    loadMore(): Promise<void>;
+    /**
+     * Send optimistically. Aborting `signal` cancels the data-source request;
+     * the message is then marked failed so it can be retried.
+     */
+    send(input: Omit<OutgoingMessage, "clientId">, signal?: AbortSignal): Promise<void>;
+    retry(clientId: string): Promise<void>;
+    protected onDispose(): void;
+}
+//# sourceMappingURL=conversation.d.ts.map

package/dist/chat/conversation.d.ts.map

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

package/dist/chat/conversation.js

@@ -0,0 +1,204 @@
+import { ObservableController, } from "../controller.js";
+export class ConversationController extends ObservableController {
+    #source;
+    #createClientId;
+    #now;
+    #abort = new AbortController();
+    #unsubscribe;
+    constructor(source, options = {}) {
+        const now = options.now ?? Date.now;
+        super({ status: "idle", messages: [], hasMore: false }, now);
+        this.#source = source;
+        this.#now = now;
+        this.#createClientId =
+            options.createClientId ?? (() => crypto.randomUUID());
+    }
+    async load() {
+        this.assertActive();
+        this.#abort.abort();
+        this.#abort = new AbortController();
+        this.transition({ status: "loading", messages: [], hasMore: false });
+        try {
+            const page = await this.#source.load(undefined, this.#abort.signal);
+            if (this.#abort.signal.aborted)
+                return;
+            this.transition(pageSnapshot(page));
+            this.#unsubscribe?.();
+            this.#unsubscribe = this.#source.subscribe((event) => this.#receive(event));
+        }
+        catch (cause) {
+            if (!this.#abort.signal.aborted)
+                this.transition({
+                    status: "error",
+                    messages: [],
+                    hasMore: false,
+                    error: errorMessage(cause),
+                });
+        }
+    }
+    async loadMore() {
+        const current = this.getSnapshot();
+        if (current.status === "loading_more" || current.cursor === undefined)
+            return;
+        this.transition({ ...conversationFields(current), status: "loading_more" });
+        try {
+            const page = await this.#source.load(current.cursor, this.#abort.signal);
+            if (this.#abort.signal.aborted)
+                return;
+            this.transition({
+                status: "ready",
+                messages: mergeMessages(current.messages, page.messages),
+                hasMore: page.nextCursor !== undefined,
+                ...(page.nextCursor === undefined ? {} : { cursor: page.nextCursor }),
+            });
+        }
+        catch (cause) {
+            this.transition({
+                ...conversationFields(current),
+                status: "error",
+                error: errorMessage(cause),
+            });
+        }
+    }
+    /**
+     * Send optimistically. Aborting `signal` cancels the data-source request;
+     * the message is then marked failed so it can be retried.
+     */
+    async send(input, signal) {
+        const clientId = this.#createClientId();
+        await this.#send({ ...input, clientId }, false, signal);
+    }
+    async retry(clientId) {
+        const message = this.getSnapshot().messages.find((candidate) => candidate.clientId === clientId);
+        if (message === undefined || message.status !== "failed")
+            throw new Error(`Failed message ${clientId} was not found.`);
+        await this.#send({
+            clientId,
+            text: message.text,
+            ...(message.replyTo === undefined ? {} : { replyTo: message.replyTo }),
+            ...(message.attachments === undefined
+                ? {}
+                : { attachments: message.attachments }),
+        }, true);
+    }
+    onDispose() {
+        this.#abort.abort();
+        this.#unsubscribe?.();
+        this.#unsubscribe = undefined;
+    }
+    async #send(outgoing, replacing, external) {
+        this.assertActive();
+        const current = this.getSnapshot();
+        const optimistic = {
+            id: outgoing.clientId,
+            clientId: outgoing.clientId,
+            text: outgoing.text,
+            createdAt: this.#now(),
+            direction: "outbound",
+            status: "pending",
+            ...(outgoing.replyTo === undefined ? {} : { replyTo: outgoing.replyTo }),
+            ...(outgoing.attachments === undefined
+                ? {}
+                : { attachments: outgoing.attachments }),
+        };
+        const messages = replacing
+            ? replaceByClientId(current.messages, optimistic)
+            : [optimistic, ...current.messages];
+        this.transition({
+            ...conversationFields(current),
+            status: "ready",
+            messages,
+        });
+        const signal = eitherSignal(this.#abort.signal, external);
+        try {
+            const acknowledged = await this.#source.send(outgoing, signal.signal);
+            if (!this.#abort.signal.aborted)
+                this.#replaceMessage(outgoing.clientId, {
+                    ...acknowledged,
+                    status: "sent",
+                });
+        }
+        catch (cause) {
+            if (!this.#abort.signal.aborted)
+                this.#replaceMessage(outgoing.clientId, {
+                    ...optimistic,
+                    status: "failed",
+                    error: external?.aborted === true
+                        ? "Message send was cancelled."
+                        : errorMessage(cause),
+                });
+        }
+        finally {
+            signal.release();
+        }
+    }
+    #receive(event) {
+        const current = this.getSnapshot();
+        const messages = event.type === "delete"
+            ? current.messages.filter(({ id }) => id !== event.messageId)
+            : mergeMessages(current.messages, [event.message]);
+        this.transition({
+            ...conversationFields(current),
+            status: "ready",
+            messages,
+        });
+    }
+    #replaceMessage(clientId, message) {
+        const current = this.getSnapshot();
+        this.transition({
+            ...conversationFields(current),
+            status: "ready",
+            messages: replaceByClientId(current.messages, message),
+        });
+    }
+}
+/** A signal that aborts when either input does, plus listener cleanup. */
+function eitherSignal(own, external) {
+    if (external === undefined)
+        return { signal: own, release: () => undefined };
+    const combined = new AbortController();
+    const abort = () => combined.abort();
+    if (own.aborted || external.aborted)
+        abort();
+    own.addEventListener("abort", abort, { once: true });
+    external.addEventListener("abort", abort, { once: true });
+    return {
+        signal: combined.signal,
+        release: () => {
+            own.removeEventListener("abort", abort);
+            external.removeEventListener("abort", abort);
+        },
+    };
+}
+function pageSnapshot(page) {
+    return {
+        status: "ready",
+        messages: mergeMessages([], page.messages),
+        hasMore: page.nextCursor !== undefined,
+        ...(page.nextCursor === undefined ? {} : { cursor: page.nextCursor }),
+    };
+}
+function conversationFields(snapshot) {
+    return {
+        messages: snapshot.messages,
+        hasMore: snapshot.hasMore,
+        ...(snapshot.cursor === undefined ? {} : { cursor: snapshot.cursor }),
+    };
+}
+function replaceByClientId(messages, message) {
+    const index = messages.findIndex((candidate) => candidate.id === message.id ||
+        (message.clientId !== undefined &&
+            candidate.clientId === message.clientId));
+    if (index < 0)
+        return [message, ...messages];
+    return messages.map((candidate, candidateIndex) => candidateIndex === index ? message : candidate);
+}
+function mergeMessages(current, incoming) {
+    return incoming.reduce((messages, message) => replaceByClientId(messages, message), [...current]);
+}
+function errorMessage(cause) {
+    return cause instanceof Error
+        ? cause.message
+        : "Conversation request failed.";
+}
+//# sourceMappingURL=conversation.js.map

package/dist/chat/conversation.js.map

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

package/dist/chat/index.d.ts

@@ -0,0 +1,4 @@
+export { ConversationController, type ConversationControllerOptions, type ConversationDataSource, type ConversationEvent, type ConversationMessage, type ConversationPage, type ConversationSnapshot, type MessageAttachment, type MessageDirection, type MessageStatus, type OutgoingMessage, } from "./conversation.js";
+export { MessageComposerController, createConversationComposerActions, localAttachmentFromFile, type ComposerActions, type ComposerAttachment, type ComposerDraft, type LocalAttachment, type MessageComposerOptions, type MessageComposerSnapshot, } from "./composer.js";
+export { VoiceNoteRecorder, voiceNoteName, type MediaRecorderConstructor, type VoiceNoteError, type VoiceNoteRecorderOptions, type VoiceNoteRecorderSnapshot, type VoiceNoteStatus, } from "./voice-recorder.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/chat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chat/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,yBAAyB,EACzB,iCAAiC,EACjC,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/chat/index.js

@@ -0,0 +1,4 @@
+export { ConversationController, } from "./conversation.js";
+export { MessageComposerController, createConversationComposerActions, localAttachmentFromFile, } from "./composer.js";
+export { VoiceNoteRecorder, voiceNoteName, } from "./voice-recorder.js";
+//# sourceMappingURL=index.js.map

package/dist/chat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chat/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GAWvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,yBAAyB,EACzB,iCAAiC,EACjC,uBAAuB,GAOxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iBAAiB,EACjB,aAAa,GAMd,MAAM,qBAAqB,CAAC"}

package/dist/chat/voice-recorder.d.ts

@@ -0,0 +1,75 @@
+import { ObservableController, type ControllerSnapshot } from "../controller.js";
+export type VoiceNoteStatus = "idle" | "requesting" | "recording" | "stopping" | "error";
+/** Why the last recording attempt failed. */
+export type VoiceNoteError = "permission-denied" | "unavailable" | "failed";
+export interface VoiceNoteRecorderSnapshot extends ControllerSnapshot {
+    readonly status: VoiceNoteStatus;
+    /** Milliseconds recorded so far; `0` when idle. */
+    readonly elapsed: number;
+    /** Input level from `0` to `1`, updated about every animation frame. */
+    readonly level: number;
+    /** Container type of the recording: `audio/webm`, `audio/ogg`, or `audio/mp4`. */
+    readonly mimeType?: string;
+    readonly error?: VoiceNoteError;
+}
+type MediaRecorderLike = Pick<MediaRecorder, "start" | "stop" | "state" | "mimeType"> & {
+    ondataavailable: ((event: {
+        readonly data: Blob;
+    }) => void) | null;
+    onstop: (() => void) | null;
+    onerror: (() => void) | null;
+};
+export interface MediaRecorderConstructor {
+    new (stream: MediaStream, options?: {
+        mimeType?: string;
+    }): MediaRecorderLike;
+    isTypeSupported?(type: string): boolean;
+}
+type AudioContextLike = {
+    createMediaStreamSource(stream: MediaStream): {
+        connect(node: unknown): void;
+    };
+    createAnalyser(): Pick<AnalyserNode, "fftSize" | "frequencyBinCount" | "getByteTimeDomainData">;
+    close(): Promise<void>;
+};
+export interface VoiceNoteRecorderOptions {
+    readonly mediaDevices?: Pick<MediaDevices, "getUserMedia">;
+    readonly MediaRecorder?: MediaRecorderConstructor;
+    /** Pass `null` to skip the level meter. */
+    readonly AudioContext?: (new () => AudioContextLike) | null;
+    readonly requestAnimationFrame?: (callback: () => void) => number;
+    readonly cancelAnimationFrame?: (handle: number) => void;
+    readonly now?: () => number;
+    /** Shortest interval between published level updates. Defaults to 50 ms. */
+    readonly updateInterval?: number;
+}
+/**
+ * Records a voice note from the microphone with `getUserMedia` and
+ * `MediaRecorder`, publishing status, elapsed time, and input level.
+ * `stop()` resolves with the recording as a `File`; `cancel()` discards it.
+ * Microphone tracks stop whenever recording ends and on `dispose()`.
+ */
+export declare class VoiceNoteRecorder extends ObservableController<VoiceNoteRecorderSnapshot> {
+    #private;
+    constructor(options?: VoiceNoteRecorderOptions);
+    /** Whether this environment can record: `getUserMedia` and `MediaRecorder`. */
+    static isSupported(options?: VoiceNoteRecorderOptions): boolean;
+    /** Ask for the microphone and start recording. Resolves once recording. */
+    start(): Promise<void>;
+    /**
+     * Stop recording and resolve with the voice note, or `undefined` when
+     * nothing was recording or the recorder produced no audio.
+     */
+    stop(): Promise<File | undefined>;
+    /** Discard the recording, or abandon a pending permission request. */
+    cancel(): void;
+    protected onDispose(): void;
+    dispose(): void;
+}
+/**
+ * `voice-note-<ISO time>.webm` (`.ogg` or `.m4a` for those containers), with
+ * `:` replaced for portability.
+ */
+export declare function voiceNoteName(type: string, time?: number): string;
+export {};
+//# sourceMappingURL=voice-recorder.d.ts.map

package/dist/chat/voice-recorder.d.ts.map

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