@bun-native/protocol 0.33.0 → 0.33.1

package/README.md

@@ -2,4 +2,4 @@
 
 The private native protocol shared by Bun Native packages and hosts.
 
-Part of [Bun Native](https://github.com/0xPlayerOne/bun-native), an experimental developer preview. Version 0.33.0 was built from [fa8bef754122](https://github.com/0xPlayerOne/bun-native/tree/fa8bef754122621d4235eb06e30bb1085b4f7b1e) and published from GitHub Actions with npm provenance. Use the Bun revision pinned in that commit's toolchain.json. Start with the [getting-started guide](https://github.com/0xPlayerOne/bun-native/blob/fa8bef754122621d4235eb06e30bb1085b4f7b1e/docs/getting-started.md); `bun-native host install` fetches the matching release host. The license notice is in LICENSE.
+Part of [Bun Native](https://github.com/0xPlayerOne/bun-native), an experimental developer preview. Version 0.33.1 was built from [c56fdd675365](https://github.com/0xPlayerOne/bun-native/tree/c56fdd6753653a10144a4167c1d3dfb3c38a0647) and published from GitHub Actions with npm provenance. Use the Bun revision pinned in that commit's toolchain.json. Start with the [getting-started guide](https://github.com/0xPlayerOne/bun-native/blob/c56fdd6753653a10144a4167c1d3dfb3c38a0647/docs/getting-started.md); `bun-native host install` fetches the matching release host. The license notice is in LICENSE.

package/bun-native-source.json

@@ -1,63 +1,63 @@
 {
   "schemaVersion": 1,
-  "commit": "fa8bef754122621d4235eb06e30bb1085b4f7b1e",
-  "tree": "f805e2eb19a4e10fc29d1dc827cf5bc617b5773b",
+  "commit": "c56fdd6753653a10144a4167c1d3dfb3c38a0647",
+  "tree": "c6e81b3f9d041e11dd0413b5fdd7a50910383854",
   "files": {
     "package.json": {
-      "bytes": 2164,
-      "sha256": "db50b6f81f25c113a46f8c9b038bc548a92effaeb4ad9562e5e95044baa7b66f"
+      "bytes": 2115,
+      "sha256": "caf866d56f3cd7530d5735ecbf62512e9e22526bc44c75a4b48a18c26352c0b8"
     },
     "packages/protocol/package.json": {
       "bytes": 129,
       "sha256": "668f52c10a6db801c2d0c68c59998c489b50c0bb79cb7f60298dfbb83923b0ba"
     },
     "packages/protocol/src/app-menu.ts": {
-      "bytes": 6435,
-      "sha256": "52ec565f7423671a13e3bc43d49129496ed9869f22b4fa1b7e3eba79191137b8"
+      "bytes": 6687,
+      "sha256": "a0346cff0bfe26a1b2d1eaf1470521d5602d59dd54f831b3353be56499a5efc3"
     },
     "packages/protocol/src/dialogs.ts": {
-      "bytes": 4896,
-      "sha256": "c2ea74d7175c75710146c788b261e5566301da5952359b8e50bc69a323cdef00"
+      "bytes": 5261,
+      "sha256": "c26aab88e0e6ca9838b8c7dd471165e03f967694576a257dec88cff8343e4175"
     },
     "packages/protocol/src/drops.ts": {
-      "bytes": 1968,
-      "sha256": "478b9952e406853b22e32e8b5c227fdc5936363665d984c628d18581de112191"
+      "bytes": 2029,
+      "sha256": "03894f9b2b40f7645e74824de630bebc4d7d7145eafade79739248126826a42b"
     },
     "packages/protocol/src/elements.ts": {
-      "bytes": 16161,
-      "sha256": "3529a4f7fefa9d56880a5f32be83b7daea9ad492784478ddc413d2deb85f5283"
+      "bytes": 17017,
+      "sha256": "b831c4906806cd8b46aab29983481c85617b84b4bcc6cde515c3c2d8f5f4dfb1"
     },
     "packages/protocol/src/files.ts": {
-      "bytes": 10163,
-      "sha256": "d4d890f22b6abdc713e544a4e3f7b0ed53df4a1d5f44044febea8d8cf9ca96a5"
+      "bytes": 10818,
+      "sha256": "4fda4c2ebcc489f330b52ff042fe3b005b7b09718799f4b684d06c7728b86730"
     },
     "packages/protocol/src/framing.ts": {
-      "bytes": 3259,
-      "sha256": "47d2473785f245d8f85bd1447fba3f7ed47d5ddac170f590df5c83623064158a"
+      "bytes": 4321,
+      "sha256": "63148dfde50d4e98dafd8e1923db43d290565453a28113cf356ed3e33c4a5d70"
     },
     "packages/protocol/src/index.ts": {
-      "bytes": 3388,
-      "sha256": "7c7fd785b5037bc74ce0594f0ec5c49fca7ef9ae0b4dbab8fbf83d8427f6ead8"
+      "bytes": 2940,
+      "sha256": "3aa7a5bb90bbcb4c58fa999a6179fcca860b53913984efb857505d90438e79ae"
     },
     "packages/protocol/src/message-dialogs.ts": {
-      "bytes": 3997,
-      "sha256": "551dc23a2fde7771c28e485212d670f37db199da6f2f006344b0dc6b9064ef2b"
+      "bytes": 4229,
+      "sha256": "3fe42b3c42ff255761a867c87d0ea69f0404ee9dd64ba57cda9f9573588db210"
     },
     "packages/protocol/src/messages.ts": {
-      "bytes": 43791,
-      "sha256": "cef29b0d2fa4b84d73df5c9b8abbf321dafc6a66d688ad00838f0c8aa50a1d03"
+      "bytes": 48950,
+      "sha256": "17d92d1b5f08fb04f1dc9e6269291ffc7ff39f3c6ace3c9a6b7b216c6a63c2d3"
     },
     "packages/protocol/src/processes.ts": {
-      "bytes": 9709,
-      "sha256": "80f109623ec5f17bc21fb20c4e3093829124839c6c9e5b2457120bff0a45c778"
+      "bytes": 10019,
+      "sha256": "b64ee81b209a4e6ccf0965409c355a1bc3bfa8d813668aec385b50050be4f2b6"
     },
     "packages/protocol/src/services.ts": {
-      "bytes": 7587,
-      "sha256": "eb128b1ef12d2650acc53b71c2c802f35d3fb983d1f584aa1d81251adfccd37b"
+      "bytes": 7933,
+      "sha256": "4906b13929e96382fe55c8f94316e5b6629c74a6482ce25c55c621bc449a45e9"
     },
     "packages/protocol/src/values.ts": {
-      "bytes": 2078,
-      "sha256": "75d8f7ee9772c1aa2929a9dc4c416f42569795db089d17321398c3cdf482731b"
+      "bytes": 2365,
+      "sha256": "cca3d96f72dde820f154b6e492ea1a94ee33d8af8da44aca6fd1039912de63c1"
     },
     "LICENSE": {
       "bytes": 1075,
@@ -65,8 +65,8 @@
     }
   },
   "toolchain": {
-    "bytes": 3012,
-    "sha256": "00c3f707aae8abe9ca75cd2e162f5e1c7c34362a03675da39afead60d856066a"
+    "bytes": 3234,
+    "sha256": "9f4d9362cb4cc38c0f4e705295789a0cbfec46ffdd007e0541b9441a7c3003a7"
   },
   "dependencyLock": {
     "bytes": 28357,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bun-native/protocol",
-  "version": "0.33.0",
+  "version": "0.33.1",
   "type": "module",
   "license": "MIT",
   "files": [

package/src/app-menu.ts

@@ -1,16 +1,15 @@
 import { ProtocolError } from './framing.ts'
-import { keys, object, string } from './values.ts'
+import { fields, keys, object, string } from './values.ts'
 
 /** Top-level menus in one menu bar. */
-export const MAX_APP_MENUS = 16
+const MAX_APP_MENUS = 16
 /** Items, separators and submenus in one menu bar, at every depth. */
 export const MAX_APP_MENU_ENTRIES = 128
 /** A top-level menu is depth 1; submenus nest at most two levels below it. */
 export const MAX_APP_MENU_DEPTH = 3
-export const MAX_APP_MENU_LABEL_BYTES = 64
-export const MAX_APP_MENU_ITEM_ID_BYTES = 64
+const MAX_APP_MENU_LABEL_BYTES = 64
 
-export const APP_MENU_NAMED_KEYS = Object.freeze([
+const APP_MENU_NAMED_KEYS = Object.freeze([
   'enter',
   'escape',
   'tab',
@@ -26,7 +25,7 @@ export const APP_MENU_NAMED_KEYS = Object.freeze([
   'pageup',
   'pagedown',
 ] as const)
-export const APP_MENU_PUNCTUATION_KEYS = Object.freeze([
+const APP_MENU_PUNCTUATION_KEYS = Object.freeze([
   ',',
   '.',
   '/',
@@ -104,14 +103,17 @@ function flag(data: Record<string, unknown>, key: string): boolean {
 
 const isFunctionKey = (key: string) => /^f([1-9]|1[0-2])$/.test(key)
 
+const MENU_SHORTCUT_KEYS = fields('key', 'modifiers')
+const MENU_MODIFIER_KEYS = fields('control', 'alt', 'shift', 'platform')
+
 function parseMenuShortcut(value: unknown): MenuShortcut {
   const data = object(value)
-  keys(data, ['key', 'modifiers'])
+  keys(data, MENU_SHORTCUT_KEYS)
   const key = data['key']
   if (typeof key !== 'string' || !APP_MENU_KEYS.includes(key))
     throw new ProtocolError('Menu shortcut key is not in the closed key set')
   const raw = object(data['modifiers'])
-  keys(raw, ['control', 'alt', 'shift', 'platform'])
+  keys(raw, MENU_MODIFIER_KEYS)
   const modifiers = {
     control: flag(raw, 'control'),
     alt: flag(raw, 'alt'),
@@ -132,6 +134,10 @@ interface Census {
   shortcuts: Set<string>
 }
 
+const ENTRIES_ITEM_KEYS = fields('kind', 'id', 'label', 'shortcut', 'enabled', 'checked')
+const ENTRIES_SEPARATOR_KEYS = fields('kind')
+const ENTRIES_SUBMENU_KEYS = fields('kind', 'label', 'enabled', 'items')
+
 function entries(value: unknown, depth: number, census: Census): AppMenuEntry[] {
   if (!Array.isArray(value) || !value.length)
     throw new ProtocolError('A menu or submenu needs at least one entry')
@@ -141,7 +147,7 @@ function entries(value: unknown, depth: number, census: Census): AppMenuEntry[]
     const data = object(raw)
     switch (data['kind']) {
       case 'item': {
-        keys(data, ['kind', 'id', 'label', 'shortcut', 'enabled', 'checked'])
+        keys(data, ENTRIES_ITEM_KEYS)
         const id = parseAppMenuItemId(data['id'])
         if (census.ids.has(id))
           throw new ProtocolError('Menu item ids must be unique in a menu bar')
@@ -164,10 +170,10 @@ function entries(value: unknown, depth: number, census: Census): AppMenuEntry[]
         return entry
       }
       case 'separator':
-        keys(data, ['kind'])
+        keys(data, ENTRIES_SEPARATOR_KEYS)
         return { kind: 'separator' }
       case 'submenu': {
-        keys(data, ['kind', 'label', 'enabled', 'items'])
+        keys(data, ENTRIES_SUBMENU_KEYS)
         const text = label(data['label'], 'menu label')
         const enabled = flag(data, 'enabled')
         if (depth >= MAX_APP_MENU_DEPTH)
@@ -193,6 +199,8 @@ export function parseContextMenuItems(value: unknown): AppMenuEntry[] {
   return entries(value, 1, { entries: 0, ids: new Set(), shortcuts: new Set() })
 }
 
+const APP_MENUS_KEYS = fields('title', 'items')
+
 /** An empty bar is valid: it removes the application's menus. */
 export function parseAppMenus(value: unknown): AppMenu[] {
   if (!Array.isArray(value) || value.length > MAX_APP_MENUS)
@@ -200,7 +208,7 @@ export function parseAppMenus(value: unknown): AppMenu[] {
   const census: Census = { entries: 0, ids: new Set(), shortcuts: new Set() }
   return value.map((raw) => {
     const data = object(raw)
-    keys(data, ['title', 'items'])
+    keys(data, APP_MENUS_KEYS)
     return {
       title: label(data['title'], 'menu title'),
       items: entries(data['items'], 1, census),

package/src/dialogs.ts

@@ -1,5 +1,5 @@
 import { ProtocolError } from './framing.ts'
-import { keys, object, string } from './values.ts'
+import { fields, keys, object, string } from './values.ts'
 
 /** Live file dialogs per session. Each window owns at most one at a time. */
 export const MAX_FILE_DIALOGS = 16
@@ -56,9 +56,11 @@ function parseDialogPath(value: unknown, field = 'dialog path'): string {
   return path
 }
 
+const FILTER_KEYS = fields('name', 'patterns')
+
 function filter(value: unknown): FileFilter {
   const data = object(value)
-  keys(data, ['name', 'patterns'])
+  keys(data, FILTER_KEYS)
   const patterns = data['patterns']
   if (
     !Array.isArray(patterns) ||
@@ -74,9 +76,18 @@ function filter(value: unknown): FileFilter {
   }
 }
 
+const FILE_DIALOG_OPTIONS_KEYS = fields(
+  'mode',
+  'title',
+  'accept_label',
+  'folder',
+  'name',
+  'filters'
+)
+
 export function parseFileDialogOptions(value: unknown): FileDialogOptions {
   const data = object(value)
-  keys(data, ['mode', 'title', 'accept_label', 'folder', 'name', 'filters'])
+  keys(data, FILE_DIALOG_OPTIONS_KEYS)
   const mode = FILE_DIALOG_MODES.find((candidate) => candidate === data['mode'])
   if (!mode) throw new ProtocolError('Unknown file dialog mode')
   const options: FileDialogOptions = {
@@ -104,21 +115,25 @@ export function parseFileDialogOptions(value: unknown): FileDialogOptions {
   return options
 }
 
+const FILE_DIALOG_RESULT_SELECTED_KEYS = fields('kind', 'paths')
+const FILE_DIALOG_RESULT_CANCELLED_KEYS = fields('kind')
+const FILE_DIALOG_RESULT_FAILED_KEYS = fields('kind', 'code')
+
 export function parseFileDialogResult(value: unknown): FileDialogResult {
   const data = object(value)
   switch (data['kind']) {
     case 'selected': {
-      keys(data, ['kind', 'paths'])
+      keys(data, FILE_DIALOG_RESULT_SELECTED_KEYS)
       const paths = data['paths']
       if (!Array.isArray(paths) || paths.length < 1 || paths.length > MAX_DIALOG_PATHS)
         throw new ProtocolError('A dialog selection holds between 1 and 256 paths')
       return { kind: 'selected', paths: paths.map((path) => parseDialogPath(path)) }
     }
     case 'cancelled':
-      keys(data, ['kind'])
+      keys(data, FILE_DIALOG_RESULT_CANCELLED_KEYS)
       return { kind: 'cancelled' }
     case 'failed': {
-      keys(data, ['kind', 'code'])
+      keys(data, FILE_DIALOG_RESULT_FAILED_KEYS)
       const code = (['native_failure', 'payload_too_large'] as const).find(
         (candidate) => candidate === data['code']
       )

package/src/drops.ts

@@ -1,5 +1,5 @@
 import { ProtocolError } from './framing.ts'
-import { integer, keys, object, string } from './values.ts'
+import { fields, integer, keys, object, string } from './values.ts'
 
 /** Live drop targets across a session. */
 export const MAX_DROP_TARGETS = 32
@@ -33,12 +33,14 @@ export function parseDropItemIndex(value: unknown): number {
   return integer(value, 'Dropped item index', 0, MAX_DROP_ITEMS - 1)
 }
 
+const DROPPED_ITEMS_KEYS = fields('name')
+
 export function parseDroppedItems(value: unknown): DroppedItem[] {
   if (!Array.isArray(value) || value.length < 1 || value.length > MAX_DROP_ITEMS)
     throw new ProtocolError('A drop must deliver between 1 and ' + MAX_DROP_ITEMS + ' items')
   return value.map((entry) => {
     const data = object(entry)
-    keys(data, ['name'])
+    keys(data, DROPPED_ITEMS_KEYS)
     const name = string(data['name'], 'Dropped item name', MAX_DROP_NAME_BYTES)
     if (!name || /\p{Cc}/u.test(name))
       throw new ProtocolError('Dropped item name must be nonempty without control characters')

package/src/elements.ts

@@ -1,5 +1,5 @@
 import { ProtocolError } from './framing.ts'
-import { integer, keys, number, object, string } from './values.ts'
+import { fields, integer, keys, number, object, string } from './values.ts'
 
 export interface Style {
   direction?: 'row' | 'column'
@@ -104,7 +104,7 @@ export interface AccessibleLabel {
 }
 
 /** The largest `accessible_set_size` and `accessible_position`. */
-export const MAX_ACCESSIBLE_SET_SIZE = 2_147_483_647
+const MAX_ACCESSIBLE_SET_SIZE = 2_147_483_647
 
 /**
  * Requires `accessibility_lists_v1`. A box without `accessible_role` is layout
@@ -165,29 +165,31 @@ function requireLeafStyle(style: Style): asserts style is LeafStyle {
     throw new ProtocolError('Scrolling is supported only on box and overlay elements')
 }
 
+const STYLE_KEYS = fields(
+  'direction',
+  'gap',
+  'padding',
+  'width',
+  'height',
+  'min_width',
+  'max_width',
+  'min_height',
+  'max_height',
+  'flex_grow',
+  'flex_shrink',
+  'align_items',
+  'justify_content',
+  'overflow',
+  'scroll_anchor',
+  'background',
+  'color',
+  'font_size',
+  ...DECORATION_FIELDS
+)
+
 function parseStyle(value: unknown): Style {
   const data = object(value)
-  keys(data, [
-    'direction',
-    'gap',
-    'padding',
-    'width',
-    'height',
-    'min_width',
-    'max_width',
-    'min_height',
-    'max_height',
-    'flex_grow',
-    'flex_shrink',
-    'align_items',
-    'justify_content',
-    'overflow',
-    'scroll_anchor',
-    'background',
-    'color',
-    'font_size',
-    ...DECORATION_FIELDS,
-  ])
+  keys(data, STYLE_KEYS)
   const style: Style = {}
   for (const key of ['gap', 'padding'] as const)
     if (key in data) style[key] = number(data[key], key, 0, 4_096)
@@ -310,24 +312,60 @@ function boxAccessibility(element: Record<string, unknown>): BoxAccessibility {
   }
 }
 
-/** Normalize and validate the entire property set, including JavaScript consumers. */
+const ELEMENT_BOX_KEYS = fields(
+  'kind',
+  'accessible_role',
+  'accessible_label',
+  'accessible_set_size',
+  'accessible_position',
+  'accessible_selected',
+  'style'
+)
+const ELEMENT_TEXT_KEYS = fields('kind', 'text', 'accessible_live', 'style')
+const ELEMENT_BUTTON_KEYS = fields('kind', 'text', 'disabled', 'style')
+const ELEMENT_INPUT_KEYS = fields('kind', 'value', 'placeholder', 'disabled', 'read_only', 'style')
+const ELEMENT_SPLIT_KEYS = fields('kind', 'ratio', 'min_size', 'accessible_label', 'style')
+const ELEMENT_OVERLAY_KEYS = fields(
+  'kind',
+  'anchor',
+  'modal',
+  'surface',
+  'autofocus',
+  'navigation',
+  'accessible_label',
+  'style'
+)
+
+/**
+ * Elements this module produced. Each is frozen with its style, so it is still
+ * exactly the normalized value that passed validation.
+ */
+const parsed = new WeakSet<Element>()
+
+/**
+ * Normalize and validate the entire property set, including JavaScript consumers.
+ *
+ * The result is frozen and returned unchanged when parsed again, so core's
+ * normalized elements cross the runtime boundary in O(1). Any other value,
+ * including an unfrozen copy of a parsed element, is validated in full.
+ */
 export function parseElement(value: unknown): Element {
+  if (parsed.has(value as Element)) return value as Element
+  const element = validElement(value)
+  Object.freeze(element.style)
+  parsed.add(Object.freeze(element))
+  return element
+}
+
+function validElement(value: unknown): Element {
   const element = object(value)
   const style = 'style' in element ? parseStyle(element['style']) : {}
   switch (element['kind']) {
     case 'box':
-      keys(element, [
-        'kind',
-        'accessible_role',
-        'accessible_label',
-        'accessible_set_size',
-        'accessible_position',
-        'accessible_selected',
-        'style',
-      ])
+      keys(element, ELEMENT_BOX_KEYS)
       return { kind: 'box', ...boxAccessibility(element), style }
     case 'text':
-      keys(element, ['kind', 'text', 'accessible_live', 'style'])
+      keys(element, ELEMENT_TEXT_KEYS)
       requireLeafStyle(style)
       return {
         kind: 'text',
@@ -343,7 +381,7 @@ export function parseElement(value: unknown): Element {
         style,
       }
     case 'button': {
-      keys(element, ['kind', 'text', 'disabled', 'style'])
+      keys(element, ELEMENT_BUTTON_KEYS)
       requireLeafStyle(style)
       if ('disabled' in element && typeof element['disabled'] !== 'boolean')
         throw new ProtocolError('disabled must be a boolean')
@@ -355,7 +393,7 @@ export function parseElement(value: unknown): Element {
       }
     }
     case 'input': {
-      keys(element, ['kind', 'value', 'placeholder', 'disabled', 'read_only', 'style'])
+      keys(element, ELEMENT_INPUT_KEYS)
       requireLeafStyle(style)
       for (const name of ['disabled', 'read_only'])
         if (name in element && typeof element[name] !== 'boolean')
@@ -371,7 +409,7 @@ export function parseElement(value: unknown): Element {
       }
     }
     case 'split': {
-      keys(element, ['kind', 'ratio', 'min_size', 'accessible_label', 'style'])
+      keys(element, ELEMENT_SPLIT_KEYS)
       requireLeafStyle(style)
       if (
         style.gap !== undefined ||
@@ -388,16 +426,7 @@ export function parseElement(value: unknown): Element {
       }
     }
     case 'overlay': {
-      keys(element, [
-        'kind',
-        'anchor',
-        'modal',
-        'surface',
-        'autofocus',
-        'navigation',
-        'accessible_label',
-        'style',
-      ])
+      keys(element, ELEMENT_OVERLAY_KEYS)
       const label = accessibleLabel(element)
       const anchor =
         'anchor' in element ? choice(element['anchor'], 'anchor', ['window', 'parent']) : 'window'

package/src/files.ts

@@ -1,5 +1,5 @@
 import { ProtocolError } from './framing.ts'
-import { integer, keys, object, string } from './values.ts'
+import { fields, integer, keys, object, string } from './values.ts'
 
 export const MAX_FILESYSTEM_ROOTS = 8
 export const MAX_FILE_GRANTS = 32
@@ -87,9 +87,11 @@ export function parseFileAccess(value: unknown): FileAccess {
   return value as FileAccess
 }
 
+const ROOT_KEYS = fields('id', 'path', 'access')
+
 function root(value: unknown): FilesystemRoot {
   const data = object(value)
-  keys(data, ['id', 'path', 'access'])
+  keys(data, ROOT_KEYS)
   return {
     id: parseRootId(data['id']),
     path: parseRootPath(data['path']),
@@ -158,6 +160,11 @@ export function parseChunk(value: unknown): string {
 const WRITE_MODES: readonly WriteMode[] = ['create', 'truncate', 'append']
 const FILE_KINDS: readonly FileKind[] = ['file', 'directory', 'symlink', 'other']
 
+const FILE_OPERATION_STAT_KEYS = fields('kind')
+const FILE_OPERATION_LIST_KEYS = fields('kind', 'after')
+const FILE_OPERATION_READ_KEYS = fields('kind', 'offset', 'length')
+const FILE_OPERATION_WRITE_KEYS = fields('kind', 'mode', 'data')
+
 export function parseFileOperation(value: unknown, path: string): FileOperation {
   const data = object(value)
   const writes = ['write', 'create_directory', 'remove'].includes(data['kind'] as string)
@@ -167,15 +174,15 @@ export function parseFileOperation(value: unknown, path: string): FileOperation
     case 'stat':
     case 'create_directory':
     case 'remove':
-      keys(data, ['kind'])
+      keys(data, FILE_OPERATION_STAT_KEYS)
       return { kind: data['kind'] }
     case 'list':
-      keys(data, ['kind', 'after'])
+      keys(data, FILE_OPERATION_LIST_KEYS)
       return 'after' in data
         ? { kind: 'list', after: parseFileName(data['after']) }
         : { kind: 'list' }
     case 'read':
-      keys(data, ['kind', 'offset', 'length'])
+      keys(data, FILE_OPERATION_READ_KEYS)
       return {
         kind: 'read',
         offset: integer(
@@ -187,7 +194,7 @@ export function parseFileOperation(value: unknown, path: string): FileOperation
         length: integer(data['length'], 'file read length', 1, MAX_FILE_CHUNK_BYTES),
       }
     case 'write': {
-      keys(data, ['kind', 'mode', 'data'])
+      keys(data, FILE_OPERATION_WRITE_KEYS)
       const mode = WRITE_MODES.find((item) => item === data['mode'])
       if (!mode) throw new ProtocolError('Unknown file write mode')
       return { kind: 'write', mode, data: parseChunk(data['data']) }
@@ -211,11 +218,18 @@ function compareBytes(left: string, right: string): number {
   return a.length - b.length
 }
 
+const FILE_RESULT_STAT_KEYS = fields('kind', 'file_kind', 'size', 'modified_ms')
+const FILE_RESULT_LIST_KEYS = fields('kind', 'entries', 'complete', 'omitted')
+const FILE_LIST_ENTRY_KEYS = fields('name', 'kind')
+const FILE_RESULT_READ_KEYS = fields('kind', 'data', 'end_of_file')
+const FILE_RESULT_WRITTEN_KEYS = fields('kind', 'bytes')
+const FILE_RESULT_DONE_KEYS = fields('kind')
+
 export function parseFileResult(value: unknown): FileResult {
   const data = object(value)
   switch (data['kind']) {
     case 'stat':
-      keys(data, ['kind', 'file_kind', 'size', 'modified_ms'])
+      keys(data, FILE_RESULT_STAT_KEYS)
       return {
         kind: 'stat',
         file_kind: fileKind(data['file_kind']),
@@ -227,13 +241,13 @@ export function parseFileResult(value: unknown): FileResult {
         ),
       }
     case 'list': {
-      keys(data, ['kind', 'entries', 'complete', 'omitted'])
+      keys(data, FILE_RESULT_LIST_KEYS)
       const entries = data['entries']
       if (!Array.isArray(entries) || entries.length > MAX_DIRECTORY_ENTRIES)
         throw new ProtocolError('Directory page exceeds ' + MAX_DIRECTORY_ENTRIES + ' entries')
       const parsed = entries.map((entry) => {
         const item = object(entry)
-        keys(item, ['name', 'kind'])
+        keys(item, FILE_LIST_ENTRY_KEYS)
         return { name: parseFileName(item['name']), kind: fileKind(item['kind']) }
       })
       for (let index = 1; index < parsed.length; index++)
@@ -249,18 +263,18 @@ export function parseFileResult(value: unknown): FileResult {
       }
     }
     case 'read':
-      keys(data, ['kind', 'data', 'end_of_file'])
+      keys(data, FILE_RESULT_READ_KEYS)
       if (typeof data['end_of_file'] !== 'boolean')
         throw new ProtocolError('File end-of-file flag must be a boolean')
       return { kind: 'read', data: parseChunk(data['data']), end_of_file: data['end_of_file'] }
     case 'written':
-      keys(data, ['kind', 'bytes'])
+      keys(data, FILE_RESULT_WRITTEN_KEYS)
       return {
         kind: 'written',
         bytes: integer(data['bytes'], 'written bytes', 0, MAX_FILE_CHUNK_BYTES),
       }
     case 'done':
-      keys(data, ['kind'])
+      keys(data, FILE_RESULT_DONE_KEYS)
       return { kind: 'done' }
     default:
       throw new ProtocolError('Unknown file result')