@runtypelabs/persona 4.25.0 → 4.26.1

package/src/utils/attachment-manager.ts

@@ -114,10 +114,10 @@ export class AttachmentManager {
       AttachmentManagerConfig,
       "onFileRejected" | "onAttachmentsChange" | "adapter"
     >;
-  private previewsContainer: HTMLElement | null = null;
+  #previewsContainer: HTMLElement | null = null;
   /** In-flight `adapter.add` per attachment id; aborted on remove/clear/destroy. */
-  private pendingAdds = new Map<string, AbortController>();
-  private destroyed = false;
+  #pendingAdds = new Map<string, AbortController>();
+  #destroyed = false;
 
   constructor(config: AttachmentManagerConfig = {}) {
     this.config = {
@@ -131,12 +131,12 @@ export class AttachmentManager {
   }
 
   /** True when the host supplied an adapter (tiles then show upload state). */
-  private hasCustomAdapter(): boolean {
+  #hasCustomAdapter(): boolean {
     return typeof this.config.adapter?.add === "function";
   }
 
-  private adapter(): AgentWidgetAttachmentAdapter {
-    return this.hasCustomAdapter()
+  #adapter(): AgentWidgetAttachmentAdapter {
+    return this.#hasCustomAdapter()
       ? (this.config.adapter as AgentWidgetAttachmentAdapter)
       : BASE64_ADAPTER;
   }
@@ -145,7 +145,7 @@ export class AttachmentManager {
    * Set the previews container element
    */
   setPreviewsContainer(container: HTMLElement | null): void {
-    this.previewsContainer = container;
+    this.#previewsContainer = container;
   }
 
   /**
@@ -153,14 +153,14 @@ export class AttachmentManager {
    * rebuild swaps the footer, so pending attachments must follow it.
    */
   remountPreviews(container: HTMLElement | null): void {
-    this.previewsContainer = container;
+    this.#previewsContainer = container;
     if (container) {
       container.innerHTML = "";
       for (const attachment of this.attachments) {
-        this.renderPreview(attachment);
+        this.#renderPreview(attachment);
       }
     }
-    this.updatePreviewsVisibility();
+    this.#updatePreviewsVisibility();
   }
 
   /**
@@ -236,7 +236,7 @@ export class AttachmentManager {
    * Handle an array of files (e.g., clipboard image paste)
    */
   async handleFiles(files: readonly File[]): Promise<void> {
-    if (!files.length || this.destroyed) return;
+    if (!files.length || this.#destroyed) return;
 
     const accepted: PendingAttachment[] = [];
     for (const file of files) {
@@ -265,18 +265,18 @@ export class AttachmentManager {
         file,
         previewUrl: isImageFile(file) ? URL.createObjectURL(file) : null,
         contentPart: null,
-        status: this.hasCustomAdapter() ? "uploading" : "processing",
-        progress: this.hasCustomAdapter() ? 0 : undefined
+        status: this.#hasCustomAdapter() ? "uploading" : "processing",
+        progress: this.#hasCustomAdapter() ? 0 : undefined
       };
       this.attachments.push(attachment);
-      this.renderPreview(attachment);
+      this.#renderPreview(attachment);
       accepted.push(attachment);
     }
 
-    this.updatePreviewsVisibility();
-    this.notify();
+    this.#updatePreviewsVisibility();
+    this.#notify();
 
-    await Promise.all(accepted.map((attachment) => this.runAdd(attachment)));
+    await Promise.all(accepted.map((attachment) => this.#runAdd(attachment)));
   }
 
   /**
@@ -284,24 +284,24 @@ export class AttachmentManager {
    * completions from an aborted or removed attachment write no state and log
    * nothing: the user already moved on.
    */
-  private async runAdd(attachment: PendingAttachment): Promise<void> {
+  async #runAdd(attachment: PendingAttachment): Promise<void> {
     const controller = new AbortController();
-    this.pendingAdds.set(attachment.id, controller);
+    this.#pendingAdds.set(attachment.id, controller);
 
     const stale = (): boolean =>
-      this.destroyed ||
+      this.#destroyed ||
       controller.signal.aborted ||
-      this.pendingAdds.get(attachment.id) !== controller ||
+      this.#pendingAdds.get(attachment.id) !== controller ||
       !this.attachments.includes(attachment);
 
     try {
-      const part = await this.adapter().add(attachment.file, {
+      const part = await this.#adapter().add(attachment.file, {
         signal: controller.signal,
         onProgress: (progress) => {
           if (stale() || attachment.status !== "uploading") return;
           attachment.progress = clampProgress(progress);
-          this.updatePreview(attachment);
-          this.notify();
+          this.#updatePreview(attachment);
+          this.#notify();
         }
       });
       if (stale()) return;
@@ -316,31 +316,31 @@ export class AttachmentManager {
       attachment.error =
         error instanceof Error ? error.message : String(error ?? "Upload failed");
     } finally {
-      if (this.pendingAdds.get(attachment.id) === controller) {
-        this.pendingAdds.delete(attachment.id);
+      if (this.#pendingAdds.get(attachment.id) === controller) {
+        this.#pendingAdds.delete(attachment.id);
       }
     }
-    this.updatePreview(attachment);
-    this.notify();
+    this.#updatePreview(attachment);
+    this.#notify();
   }
 
   /** Retry a failed attachment from its error tile. */
   retryAttachment(id: string): void {
     const attachment = this.attachments.find((a) => a.id === id);
-    if (!attachment || attachment.status !== "error" || this.destroyed) return;
-    attachment.status = this.hasCustomAdapter() ? "uploading" : "processing";
-    attachment.progress = this.hasCustomAdapter() ? 0 : undefined;
+    if (!attachment || attachment.status !== "error" || this.#destroyed) return;
+    attachment.status = this.#hasCustomAdapter() ? "uploading" : "processing";
+    attachment.progress = this.#hasCustomAdapter() ? 0 : undefined;
     attachment.error = undefined;
-    this.updatePreview(attachment);
-    this.notify();
-    void this.runAdd(attachment);
+    this.#updatePreview(attachment);
+    this.#notify();
+    void this.#runAdd(attachment);
   }
 
   /** Abort an in-flight add without touching the attachment's own state. */
-  private abortAdd(id: string): void {
-    const controller = this.pendingAdds.get(id);
+  #abortAdd(id: string): void {
+    const controller = this.#pendingAdds.get(id);
     if (!controller) return;
-    this.pendingAdds.delete(id);
+    this.#pendingAdds.delete(id);
     controller.abort();
   }
 
@@ -353,7 +353,7 @@ export class AttachmentManager {
     if (index === -1) return;
 
     const attachment = this.attachments[index];
-    this.abortAdd(id);
+    this.#abortAdd(id);
 
     // Revoke the object URL to free memory (only for images)
     if (attachment.previewUrl) {
@@ -364,7 +364,7 @@ export class AttachmentManager {
     this.attachments.splice(index, 1);
 
     // Remove from DOM
-    const previewEl = this.previewsContainer?.querySelector(
+    const previewEl = this.#previewsContainer?.querySelector(
       `[data-attachment-id="${id}"]`
     );
     if (previewEl) {
@@ -372,14 +372,14 @@ export class AttachmentManager {
     }
 
     if (attachment.status === "ready" && attachment.contentPart) {
-      this.releasePart(attachment.contentPart);
+      this.#releasePart(attachment.contentPart);
     }
 
-    this.updatePreviewsVisibility();
-    this.notify();
+    this.#updatePreviewsVisibility();
+    this.#notify();
   }
 
-  private releasePart(part: ContentPart): void {
+  #releasePart(part: ContentPart): void {
     const remove = this.config.adapter?.remove;
     if (!remove) return;
     try {
@@ -401,47 +401,47 @@ export class AttachmentManager {
    */
   clearAttachments(): void {
     for (const attachment of this.attachments) {
-      this.abortAdd(attachment.id);
+      this.#abortAdd(attachment.id);
       if (attachment.previewUrl) {
         URL.revokeObjectURL(attachment.previewUrl);
       }
     }
 
     this.attachments = [];
-    this.pendingAdds.clear();
+    this.#pendingAdds.clear();
 
     // Clear the previews container
-    if (this.previewsContainer) {
-      this.previewsContainer.innerHTML = "";
+    if (this.#previewsContainer) {
+      this.#previewsContainer.innerHTML = "";
     }
 
-    this.updatePreviewsVisibility();
-    this.notify();
+    this.#updatePreviewsVisibility();
+    this.#notify();
   }
 
   /** Abort every in-flight upload and stop accepting new work. */
   destroy(): void {
-    if (this.destroyed) return;
-    this.destroyed = true;
-    for (const controller of this.pendingAdds.values()) controller.abort();
-    this.pendingAdds.clear();
+    if (this.#destroyed) return;
+    this.#destroyed = true;
+    for (const controller of this.#pendingAdds.values()) controller.abort();
+    this.#pendingAdds.clear();
     for (const attachment of this.attachments) {
       if (attachment.previewUrl) URL.revokeObjectURL(attachment.previewUrl);
     }
     this.attachments = [];
-    this.previewsContainer = null;
+    this.#previewsContainer = null;
   }
 
-  private notify(): void {
-    if (this.destroyed) return;
+  #notify(): void {
+    if (this.#destroyed) return;
     this.config.onAttachmentsChange?.(this.getAttachments());
   }
 
   /**
    * Render a preview for an attachment (image thumbnail or file icon)
    */
-  private renderPreview(attachment: PendingAttachment): void {
-    if (!this.previewsContainer) return;
+  #renderPreview(attachment: PendingAttachment): void {
+    if (!this.#previewsContainer) return;
 
     const isImage = isImageFile(attachment.file);
 
@@ -572,20 +572,20 @@ export class AttachmentManager {
     });
 
     previewWrapper.appendChild(removeBtn);
-    this.previewsContainer.appendChild(previewWrapper);
-    this.applyPreviewState(previewWrapper, attachment);
+    this.#previewsContainer.appendChild(previewWrapper);
+    this.#applyPreviewState(previewWrapper, attachment);
   }
 
   /** Repaint only the status layer of a live tile; the thumbnail is untouched. */
-  private updatePreview(attachment: PendingAttachment): void {
-    const tile = this.previewsContainer?.querySelector<HTMLElement>(
+  #updatePreview(attachment: PendingAttachment): void {
+    const tile = this.#previewsContainer?.querySelector<HTMLElement>(
       `[data-attachment-id="${attachment.id}"]`
     );
     if (!tile) return;
-    this.applyPreviewState(tile, attachment);
+    this.#applyPreviewState(tile, attachment);
   }
 
-  private applyPreviewState(
+  #applyPreviewState(
     tile: HTMLElement,
     attachment: PendingAttachment
   ): void {
@@ -611,9 +611,9 @@ export class AttachmentManager {
   /**
    * Update the visibility of the previews container
    */
-  private updatePreviewsVisibility(): void {
-    if (!this.previewsContainer) return;
-    this.previewsContainer.style.display =
+  #updatePreviewsVisibility(): void {
+    if (!this.#previewsContainer) return;
+    this.#previewsContainer.style.display =
       this.attachments.length > 0 ? "flex" : "none";
   }
 

package/src/utils/constants.ts

@@ -29,3 +29,6 @@ export const PORTALED_OVERLAY_Z_INDEX = DEFAULT_OVERLAY_Z_INDEX + 1;
 
 
 
+
+/** Runtype API origin used when no `apiUrl` / client API base is configured. */
+export const DEFAULT_CLIENT_API_BASE = "https://api.runtype.com";