@bun-native/protocol 0.33.0 → 0.33.1

package/src/framing.ts

@@ -1,5 +1,12 @@
-/** Maximum UTF-8 JSON payload bytes, excluding the newline delimiter. */
-export const MAX_FRAME_BYTES = 65_536
+/**
+ * Maximum command frame (runtime to host) in UTF-8 JSON bytes, excluding the
+ * newline. One transaction is one batch, so this bounds a full-window mount.
+ */
+export const MAX_FRAME_BYTES = 16_777_216
+/** Maximum event frame (host to runtime): one text value or service result. */
+export const MAX_EVENT_FRAME_BYTES = 65_536
+/** Decoder capacity kept between frames; a larger frame borrows memory while it is read. */
+const RETAINED_FRAME_BYTES = 65_536
 
 export class ProtocolError extends Error {
   override readonly name = 'ProtocolError'
@@ -24,17 +31,35 @@ export function encodeFrame(value: unknown): Uint8Array {
 }
 
 /**
- * Incremental, bounded JSON-lines decoder for a native process pipe.
+ * Incremental, bounded JSON-lines decoder for a native process pipe. `limit`
+ * is the largest frame payload it accepts: the runtime reads events with
+ * `MAX_EVENT_FRAME_BYTES`; a peer reading commands keeps the default.
  * A protocol error poisons the decoder; the caller must terminate that session.
  * Successful finish closes the decoder and is idempotent.
  */
 export class FrameDecoder {
-  private readonly buffer = new Uint8Array(MAX_FRAME_BYTES)
+  private buffer = new Uint8Array(0)
   // Preserve a leading BOM so JSON.parse rejects it, matching Rust serde_json.
   private readonly utf8 = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true })
   private length = 0
   private state: 'open' | 'finished' | 'failed' = 'open'
 
+  constructor(private readonly limit: number = MAX_FRAME_BYTES) {}
+
+  /** Append a partial frame, growing the buffer geometrically up to the limit. */
+  private append(bytes: Uint8Array): void {
+    const length = this.length + bytes.length
+    if (length > this.buffer.length) {
+      const grown = new Uint8Array(
+        Math.min(this.limit, Math.max(length, 2 * this.buffer.length, 4_096))
+      )
+      grown.set(this.buffer.subarray(0, this.length))
+      this.buffer = grown
+    }
+    this.buffer.set(bytes, this.length)
+    this.length = length
+  }
+
   push(chunk: Uint8Array): unknown[] {
     if (this.state !== 'open')
       throw new ProtocolError(
@@ -49,8 +74,7 @@ export class FrameDecoder {
         const newline = chunk.indexOf(10, start)
         const end = newline === -1 ? chunk.length : newline
         const size = end - start
-        if (this.length + size > MAX_FRAME_BYTES)
-          throw new ProtocolError('Frame exceeds byte limit')
+        if (this.length + size > this.limit) throw new ProtocolError('Frame exceeds byte limit')
         if (newline !== -1 && this.length === 0) {
           // A frame wholly inside this chunk decodes in place, without a copy.
           if (size === 0) throw new ProtocolError('Empty frame')
@@ -58,12 +82,12 @@ export class FrameDecoder {
           start = newline + 1
           continue
         }
-        this.buffer.set(chunk.subarray(start, end), this.length)
-        this.length += size
+        this.append(chunk.subarray(start, end))
         if (newline === -1) break
         const json = this.utf8.decode(this.buffer.subarray(0, this.length))
-        frames.push(JSON.parse(json) as unknown)
         this.length = 0
+        if (this.buffer.length > RETAINED_FRAME_BYTES) this.buffer = new Uint8Array(0)
+        frames.push(JSON.parse(json) as unknown)
         start = newline + 1
       }
     } catch (error) {

package/src/index.ts

@@ -1,16 +1,16 @@
-export { encodeFrame, FrameDecoder, MAX_FRAME_BYTES, ProtocolError } from './framing.ts'
+export {
+  encodeFrame,
+  FrameDecoder,
+  MAX_EVENT_FRAME_BYTES,
+  MAX_FRAME_BYTES,
+  ProtocolError,
+} from './framing.ts'
 export {
   DECORATION_FIELDS,
-  MAX_ACCESSIBLE_SET_SIZE,
   MAX_OVERLAY_DEPTH,
   parseElement,
   SPLIT_DIVIDER,
   type Element,
-  type OverlayElement,
-  type AccessibleLabel,
-  type BoxAccessibility,
-  type OverlayKeyboard,
-  type SplitStyle,
   type Style,
 } from './elements.ts'
 export { MAX_TEXT_BYTES } from './values.ts'
@@ -26,12 +26,10 @@ export {
   parseFilePath,
   parseFilesystemRoots,
   parseRootId,
-  type DirectoryEntry,
   type FileAccess,
   type FileKind,
   type FileOperation,
   type FileResult,
-  type FilesystemRoot,
   type WriteMode,
 } from './files.ts'
 export {
@@ -42,14 +40,11 @@ export {
   MAX_PROCESSES,
   parseProcessExecutables,
   parseProcessLaunch,
-  parseProcessLimits,
   parseProcessLimitsArgument,
   PROCESS_SIGNALS,
   processArguments,
   processLimitsArgument,
   processesFromArguments,
-  type ProcessExecutable,
-  type ProcessLimits,
   type ProcessExit,
   type ProcessLaunch,
   type ProcessSignal,
@@ -58,19 +53,12 @@ export {
 } from './processes.ts'
 export {
   APP_MENU_KEYS,
-  APP_MENU_NAMED_KEYS,
-  APP_MENU_PUNCTUATION_KEYS,
   MAX_APP_MENU_DEPTH,
   MAX_APP_MENU_ENTRIES,
-  MAX_APP_MENU_ITEM_ID_BYTES,
-  MAX_APP_MENU_LABEL_BYTES,
-  MAX_APP_MENUS,
   parseAppMenus,
   parseContextMenuItems,
   type AppMenu,
   type AppMenuEntry,
-  type MenuShortcut,
-  type MenuShortcutModifiers,
 } from './app-menu.ts'
 export {
   FILE_DIALOG_MODES,
@@ -88,7 +76,6 @@ export {
   type FileDialogMode,
   type FileDialogOptions,
   type FileDialogResult,
-  type FileFilter,
 } from './dialogs.ts'
 export {
   MAX_MESSAGE_DIALOG_BUTTONS,
@@ -97,8 +84,6 @@ export {
   MAX_MESSAGE_DIALOG_LABEL_BYTES,
   MAX_MESSAGE_DIALOG_MESSAGE_BYTES,
   MAX_MESSAGE_DIALOG_TITLE_BYTES,
-  MAX_MESSAGE_DIALOGS,
-  parseMessageDialogOptions,
   type MessageDialogButton,
   type MessageDialogOptions,
   type MessageDialogResult,
@@ -109,8 +94,6 @@ export {
   MAX_DROP_ITEMS,
   MAX_DROP_NAME_BYTES,
   MAX_DROP_TARGETS,
-  type DragState,
-  type DroppedItem,
   type DropRejection,
 } from './drops.ts'
 export {
@@ -138,7 +121,10 @@ export {
   PROTOCOL_VERSION,
   REQUIRED_CAPABILITIES,
   type Command,
+  type ApplicationEvent,
+  type HostEvent,
   type NativeEvent,
+  type WindowEvent,
   type Operation,
   type Limits,
   type ErrorCode,

package/src/message-dialogs.ts

@@ -1,8 +1,6 @@
 import { ProtocolError } from './framing.ts'
-import { keys, object, string } from './values.ts'
+import { fields, keys, object, string } from './values.ts'
 
-/** Live OS message dialogs per session. Each window owns at most one at a time. */
-export const MAX_MESSAGE_DIALOGS = 16
 export const MAX_MESSAGE_DIALOG_BUTTONS = 4
 export const MAX_MESSAGE_DIALOG_TITLE_BYTES = 256
 export const MAX_MESSAGE_DIALOG_MESSAGE_BYTES = 2_048
@@ -39,9 +37,11 @@ function text(value: unknown, field: string, limit: number, block: boolean): str
   return result
 }
 
+const BUTTON_KEYS = fields('id', 'label')
+
 function button(value: unknown): MessageDialogButton {
   const data = object(value)
-  keys(data, ['id', 'label'])
+  keys(data, BUTTON_KEYS)
   return {
     id: text(data['id'], 'message dialog button id', MAX_MESSAGE_DIALOG_ID_BYTES, false),
     label: text(
@@ -53,17 +53,19 @@ function button(value: unknown): MessageDialogButton {
   }
 }
 
+const MESSAGE_DIALOG_OPTIONS_KEYS = fields(
+  'title',
+  'message',
+  'detail',
+  'buttons',
+  'default_button',
+  'cancel_button',
+  'dismissible'
+)
+
 export function parseMessageDialogOptions(value: unknown): MessageDialogOptions {
   const data = object(value)
-  keys(data, [
-    'title',
-    'message',
-    'detail',
-    'buttons',
-    'default_button',
-    'cancel_button',
-    'dismissible',
-  ])
+  keys(data, MESSAGE_DIALOG_OPTIONS_KEYS)
   const list = data['buttons']
   if (!Array.isArray(list) || list.length < 1 || list.length > MAX_MESSAGE_DIALOG_BUTTONS)
     throw new ProtocolError('A message dialog needs between 1 and 4 buttons')
@@ -104,20 +106,24 @@ export function parseMessageDialogOptions(value: unknown): MessageDialogOptions
   return options
 }
 
+const MESSAGE_DIALOG_RESULT_BUTTON_KEYS = fields('kind', 'id')
+const MESSAGE_DIALOG_RESULT_DISMISSED_KEYS = fields('kind')
+const MESSAGE_DIALOG_RESULT_FAILED_KEYS = fields('kind')
+
 export function parseMessageDialogResult(value: unknown): MessageDialogResult {
   const data = object(value)
   switch (data['kind']) {
     case 'button':
-      keys(data, ['kind', 'id'])
+      keys(data, MESSAGE_DIALOG_RESULT_BUTTON_KEYS)
       return {
         kind: 'button',
         id: text(data['id'], 'message dialog result id', MAX_MESSAGE_DIALOG_ID_BYTES, false),
       }
     case 'dismissed':
-      keys(data, ['kind'])
+      keys(data, MESSAGE_DIALOG_RESULT_DISMISSED_KEYS)
       return { kind: 'dismissed' }
     case 'failed':
-      keys(data, ['kind'])
+      keys(data, MESSAGE_DIALOG_RESULT_FAILED_KEYS)
       return { kind: 'failed' }
     default:
       throw new ProtocolError('Unknown message dialog result')