From e9391166171c30b3cde43eae217f57eb426805f1 Mon Sep 17 00:00:00 2001
From: Onyx <onyxdigitalshop@gmail.com>
Date: Sat, 3 Oct 2026 09:47:11 +0200
Subject: [PATCH 1/4] Logitech: explain the empty profile list instead of just
 reporting it

A Logitech mouse that G HUB has never linked has a blank onboard profile
directory, so the profile list is empty and the only message was 'This mouse
reported no onboard profiles.' with no hint what to do. Say why and how to fix
it: link the mouse in G HUB once, then reload. Profiles appear after that
first link (issue #516).
---
 src/i18n.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/i18n.ts b/src/i18n.ts
index edbc7b0..c94a9c2 100644
--- a/src/i18n.ts
+++ b/src/i18n.ts
@@ -762,7 +762,7 @@ const en = {
   "ctl.progProfile": "Switching profile…",
   "ctl.switchingLayer": "Switching to {label}…",
   "ctl.readingProfiles": "Reading onboard profiles…",
-  "ctl.noProfiles": "This mouse reported no onboard profiles.",
+  "ctl.noProfiles": "No onboard profiles are saved on this mouse yet. Logitech mice only get them after G HUB has linked the mouse once: open G HUB, let it detect the mouse, then reload here.",
   "ctl.noNameField": "This profile format has no name field.",
   "ctl.selectedMouse": "the selected mouse",
   "ctl.autoSleep": "Auto sleep {v}",

From c0764ae421b5aa00711ae146ebd8f26d1f66e184 Mon Sep 17 00:00:00 2001
From: Onyx <onyxdigitalshop@gmail.com>
Date: Mon, 5 Oct 2026 09:03:25 +0200
Subject: [PATCH 2/4] Logitech: set up profiles on a mouse that has none,
 without G HUB

A Logitech mouse G HUB has never linked has an empty profile directory, so the
profile list was empty. Offer a Set up profiles button when the list is empty
and the mouse has a captured factory image (PRO X 3 SUPERSTRIKE): it writes the
factory profiles with profile 1 active and reloads the list. Needs the new
initializeBlankOnboardProfiles from @openmouse/protocol, so it waits on the
protocol release (issue #516).
---
 src/app/Profiles.tsx     | 10 ++++++++
 src/device/controller.ts | 49 ++++++++++++++++++++++++++++++++++++++++
 src/device/types.ts      |  2 ++
 src/i18n-ar.ts           |  1 +
 src/i18n-de.ts           |  1 +
 src/i18n-es.ts           |  1 +
 src/i18n-fr.ts           |  1 +
 src/i18n-ja.ts           |  1 +
 src/i18n-ko.ts           |  1 +
 src/i18n-pt.ts           |  1 +
 src/i18n-ru.ts           |  1 +
 src/i18n-vi.ts           |  1 +
 src/i18n-zh.ts           |  1 +
 src/i18n.ts              |  3 ++-
 14 files changed, 73 insertions(+), 1 deletion(-)

diff --git a/src/app/Profiles.tsx b/src/app/Profiles.tsx
index 452d058..f34027e 100644
--- a/src/app/Profiles.tsx
+++ b/src/app/Profiles.tsx
@@ -87,6 +87,16 @@ export function Profiles({
         >
           <IconShare />
         </button>
+        {snapshot.setupProfilesAvailable ? (
+          <button
+            id="setup-logitech-profiles"
+            type="button"
+            disabled={snapshot.settingInProgress}
+            onClick={() => void control.setUpLogitechProfiles()}
+          >
+            {t(locale, "prof.setUp")}
+          </button>
+        ) : null}
         {snapshot.resetProfilesAvailable ? (
           <button
             id="reset-logitech-profiles"
diff --git a/src/device/controller.ts b/src/device/controller.ts
index d033729..97084ce 100644
--- a/src/device/controller.ts
+++ b/src/device/controller.ts
@@ -549,6 +549,11 @@ function buildSnapshot(): ControlSnapshot {
     resetProfilesAvailable: logitechClient() !== null
       && latestDeviceStatus?.brand === "Logitech"
       && supportsFactoryReset(latestDeviceStatus?.onboardProfileFormat?.id ?? null),
+    setupProfilesAvailable: logitechClient() !== null
+      && latestDeviceStatus?.brand === "Logitech"
+      && supportsFactoryReset(latestDeviceStatus?.onboardProfileFormat?.id ?? null)
+      && onboardProfiles !== null
+      && onboardProfiles.length === 0,
     previewMode,
     previewEnabled: previewModeEnabled,
     previewEntries,
@@ -4018,6 +4023,50 @@ export async function resetLogitechProfiles(): Promise<void> {
   }
 }
 
+/**
+ * Gives a Logitech mouse with no stored profiles (G HUB has never linked it)
+ * the factory set, so G HUB is not needed first. Only offered where a complete
+ * factory image was captured, and only while the profile list is empty.
+ */
+export async function setUpLogitechProfiles(): Promise<void> {
+  if (blockedByGameProfileDraft()) return;
+  const client = logitechClient();
+  if (!client || settingInProgress || !supportsFactoryReset(lastProfileFormat?.id)) return;
+  if (onboardProfiles === null || onboardProfiles.length > 0) return;
+
+  const confirmed = window.confirm(
+    "This mouse has no onboard profiles yet.\n\n"
+    + "Set them up now? OpenMouse will write the Logitech factory profiles into the mouse's memory, with profile 1 active. This is what G HUB does the first time it links a mouse, so G HUB is not needed first.",
+  );
+  if (!confirmed) return;
+
+  settingInProgress = true;
+  readStatus = st("ctl.resetting");
+  onboardStatus = st("ctl.writingDefaults");
+  emit();
+  recordDiagnosticCommand("Set up Logitech onboard profiles on a mouse with none");
+  try {
+    await client.initializeBlankOnboardProfiles();
+    onboardProfiles = await client.readOnboardProfiles();
+    editedProfile = onboardProfiles[0]?.sector ?? "host";
+    lastDeviceMode = "Onboard";
+    const status = await client.readStatus();
+    deviceStatuses.set(client.device, status);
+    applyStatus(status);
+    readStatus = st("ctl.resetDone");
+    onboardStatus = st("ctl.resetComplete");
+  } catch (error) {
+    recordDiagnosticError(error, st("ctl.unableReset"));
+    const message = error instanceof Error ? error.message : "Unable to set up the onboard profiles.";
+    readStatus = message;
+    onboardStatus = message;
+    onboardProfiles = null;
+    await reloadOnboardProfiles();
+  } finally {
+    endDeviceWrite();
+  }
+}
+
 export function bunnyHopSupported(): boolean {
   return editedProfileEntry() !== null && capabilitiesForFormat(lastProfileFormat?.id).bunnyHop;
 }
diff --git a/src/device/types.ts b/src/device/types.ts
index 809194e..d9555ab 100644
--- a/src/device/types.ts
+++ b/src/device/types.ts
@@ -229,6 +229,8 @@ export interface ControlSnapshot {
   diagnosticsOpen: boolean;
   captureAvailable: boolean;
   resetProfilesAvailable: boolean;
+  /** A Logitech mouse with no stored profiles that OpenMouse can set up itself. */
+  setupProfilesAvailable: boolean;
 
   previewMode: PreviewMode | null;
   previewEnabled: boolean;
diff --git a/src/i18n-ar.ts b/src/i18n-ar.ts
index ab80f54..ae9b87a 100644
--- a/src/i18n-ar.ts
+++ b/src/i18n-ar.ts
@@ -568,6 +568,7 @@ export const ar: Record<I18nKey, string> = {
   "prof.reload": "إعادة تحميل الملفات",
   "prof.deleteReset": "حذف وإعادة تعيين كل ملف مدمج",
   "prof.restoreDefaults": "استعادة كل ملف مدمج نهائيًا إلى إعدادات Logitech الافتراضية",
+  "prof.setUp": "إعداد الملفات",
   "prof.openHost": "فتح إعدادات المضيف",
   "prof.hostAlready": "الماوس في وضع المضيف بالفعل",
   "prof.switchHost": "تبديل الماوس إلى وضع المضيف",
diff --git a/src/i18n-de.ts b/src/i18n-de.ts
index 096736c..5355d1d 100644
--- a/src/i18n-de.ts
+++ b/src/i18n-de.ts
@@ -569,6 +569,7 @@ export const de: Record<I18nKey, string> = {
   "prof.reload": "Profile neu laden",
   "prof.deleteReset": "Alle internen Profile löschen und zurücksetzen",
   "prof.restoreDefaults": "Alle internen Profile dauerhaft auf Logitech-Standardwerte zurücksetzen",
+  "prof.setUp": "Profile einrichten",
   "prof.openHost": "Host-Einstellungen öffnen",
   "prof.hostAlready": "Die Maus ist bereits im Host-Modus",
   "prof.switchHost": "Maus in den Host-Modus schalten",
diff --git a/src/i18n-es.ts b/src/i18n-es.ts
index f8c70ba..e9b31c2 100644
--- a/src/i18n-es.ts
+++ b/src/i18n-es.ts
@@ -569,6 +569,7 @@ export const es: Record<I18nKey, string> = {
   "prof.reload": "Recargar perfiles",
   "prof.deleteReset": "Eliminar y restablecer todos los perfiles integrados",
   "prof.restoreDefaults": "Restaurar permanentemente todos los perfiles integrados a los valores predeterminados de Logitech",
+  "prof.setUp": "Configurar perfiles",
   "prof.openHost": "Abrir configuración de host",
   "prof.hostAlready": "El mouse ya está en modo host",
   "prof.switchHost": "Cambiar el mouse a modo host",
diff --git a/src/i18n-fr.ts b/src/i18n-fr.ts
index bc77a12..c6ff782 100644
--- a/src/i18n-fr.ts
+++ b/src/i18n-fr.ts
@@ -569,6 +569,7 @@ export const fr: Record<I18nKey, string> = {
   "prof.reload": "Recharger les profils",
   "prof.deleteReset": "Supprimer et réinitialiser tous les profils intégrés",
   "prof.restoreDefaults": "Restaurer définitivement tous les profils intégrés aux valeurs par défaut Logitech",
+  "prof.setUp": "Configurer les profils",
   "prof.openHost": "Ouvrir les réglages host",
   "prof.hostAlready": "La souris est déjà en mode host",
   "prof.switchHost": "Basculer la souris en mode host",
diff --git a/src/i18n-ja.ts b/src/i18n-ja.ts
index 94910ed..46163f7 100644
--- a/src/i18n-ja.ts
+++ b/src/i18n-ja.ts
@@ -569,6 +569,7 @@ export const ja: Record<I18nKey, string> = {
   "prof.reload": "プロファイルを再読み込み",
   "prof.deleteReset": "すべての内蔵プロファイルを削除してリセット",
   "prof.restoreDefaults": "すべての内蔵プロファイルをLogitechのデフォルトに完全に復元",
+  "prof.setUp": "プロファイルを設定",
   "prof.openHost": "ホスト設定を開く",
   "prof.hostAlready": "マウスはすでにホストモードです",
   "prof.switchHost": "マウスをホストモードに切り替え",
diff --git a/src/i18n-ko.ts b/src/i18n-ko.ts
index 324cefd..489e479 100644
--- a/src/i18n-ko.ts
+++ b/src/i18n-ko.ts
@@ -569,6 +569,7 @@ export const ko: Record<I18nKey, string> = {
   "prof.reload": "프로필 다시 불러오기",
   "prof.deleteReset": "모든 내장 프로필 삭제 및 초기화",
   "prof.restoreDefaults": "모든 내장 프로필을 Logitech 기본값으로 영구 복원",
+  "prof.setUp": "프로필 설정",
   "prof.openHost": "호스트 설정 열기",
   "prof.hostAlready": "마우스가 이미 호스트 모드입니다",
   "prof.switchHost": "마우스를 호스트 모드로 전환",
diff --git a/src/i18n-pt.ts b/src/i18n-pt.ts
index 6f1af09..521793b 100644
--- a/src/i18n-pt.ts
+++ b/src/i18n-pt.ts
@@ -569,6 +569,7 @@ export const pt: Record<I18nKey, string> = {
   "prof.reload": "Recarregar perfis",
   "prof.deleteReset": "Apagar e redefinir todos os perfis internos",
   "prof.restoreDefaults": "Restaurar permanentemente todos os perfis internos aos padrões Logitech",
+  "prof.setUp": "Configurar perfis",
   "prof.openHost": "Abrir configurações do host",
   "prof.hostAlready": "O mouse já está no modo host",
   "prof.switchHost": "Trocar o mouse para o modo host",
diff --git a/src/i18n-ru.ts b/src/i18n-ru.ts
index 41e2809..77af7d7 100644
--- a/src/i18n-ru.ts
+++ b/src/i18n-ru.ts
@@ -568,6 +568,7 @@ export const ru: Record<I18nKey, string> = {
   "prof.reload": "Перезагрузить профили",
   "prof.deleteReset": "Удалить и сбросить все встроенные профили",
   "prof.restoreDefaults": "Безвозвратно вернуть все встроенные профили к настройкам Logitech",
+  "prof.setUp": "Настроить профили",
   "prof.openHost": "Открыть настройки хоста",
   "prof.hostAlready": "Мышь уже в режиме хоста",
   "prof.switchHost": "Перевести мышь в режим хоста",
diff --git a/src/i18n-vi.ts b/src/i18n-vi.ts
index 1992451..d5f97ee 100644
--- a/src/i18n-vi.ts
+++ b/src/i18n-vi.ts
@@ -517,6 +517,7 @@ export const vi: Record<I18nKey, string> = {
   "prof.reload": "Tải lại profiles",
   "prof.deleteReset": "Xóa và đặt lại mọi profile lưu trên chuột",
   "prof.restoreDefaults": "Khôi phục vĩnh viễn mọi profile lưu trên chuột về mặc định Logitech",
+  "prof.setUp": "Thiết lập hồ sơ",
   "prof.openHost": "Mở cài đặt host",
   "prof.hostAlready": "Chuột đã ở host mode",
   "prof.switchHost": "Chuyển chuột sang host mode",
diff --git a/src/i18n-zh.ts b/src/i18n-zh.ts
index de10898..2243f60 100644
--- a/src/i18n-zh.ts
+++ b/src/i18n-zh.ts
@@ -569,6 +569,7 @@ export const zh: Record<I18nKey, string> = {
   "prof.reload": "重新加载配置文件",
   "prof.deleteReset": "删除并重置全部板载配置文件",
   "prof.restoreDefaults": "将全部板载配置文件永久恢复为罗技默认值",
+  "prof.setUp": "设置配置文件",
   "prof.openHost": "打开主机设置",
   "prof.hostAlready": "鼠标已处于主机模式",
   "prof.switchHost": "将鼠标切换到主机模式",
diff --git a/src/i18n.ts b/src/i18n.ts
index c94a9c2..c2fd67b 100644
--- a/src/i18n.ts
+++ b/src/i18n.ts
@@ -573,6 +573,7 @@ const en = {
   "prof.reload": "Reload profiles",
   "prof.deleteReset": "Delete and reset every onboard profile",
   "prof.restoreDefaults": "Permanently restore every onboard profile to Logitech defaults",
+  "prof.setUp": "Set up profiles",
   "prof.openHost": "Open host settings",
   "prof.hostAlready": "The mouse is already in host mode",
   "prof.switchHost": "Switch the mouse to host mode",
@@ -762,7 +763,7 @@ const en = {
   "ctl.progProfile": "Switching profile…",
   "ctl.switchingLayer": "Switching to {label}…",
   "ctl.readingProfiles": "Reading onboard profiles…",
-  "ctl.noProfiles": "No onboard profiles are saved on this mouse yet. Logitech mice only get them after G HUB has linked the mouse once: open G HUB, let it detect the mouse, then reload here.",
+  "ctl.noProfiles": "No onboard profiles are saved on this mouse yet. Logitech mice normally get them when G HUB links the mouse once: open G HUB, let it detect the mouse, then reload here. Where Set up profiles is shown, OpenMouse can create them itself.",
   "ctl.noNameField": "This profile format has no name field.",
   "ctl.selectedMouse": "the selected mouse",
   "ctl.autoSleep": "Auto sleep {v}",

From c9a73795a71425ec44ec8d3c2c31d357eb9d4d3e Mon Sep 17 00:00:00 2001
From: Onyx <onyxdigitalshop@gmail.com>
Date: Mon, 5 Oct 2026 09:35:58 +0200
Subject: [PATCH 3/4] Profiles: style the Set up profiles button like the icon
 buttons beside it

It rendered as an unstyled browser button, a large gray block next to the small
bordered icon buttons. Reuse .icon-button with a compact text variant that uses
theme tokens only.
---
 src/app/Profiles.tsx     | 1 +
 src/control-profiles.css | 1 +
 2 files changed, 2 insertions(+)

diff --git a/src/app/Profiles.tsx b/src/app/Profiles.tsx
index f34027e..a2b6a00 100644
--- a/src/app/Profiles.tsx
+++ b/src/app/Profiles.tsx
@@ -90,6 +90,7 @@ export function Profiles({
         {snapshot.setupProfilesAvailable ? (
           <button
             id="setup-logitech-profiles"
+            className="icon-button profile-setup-button"
             type="button"
             disabled={snapshot.settingInProgress}
             onClick={() => void control.setUpLogitechProfiles()}
diff --git a/src/control-profiles.css b/src/control-profiles.css
index 3cd9a70..536e790 100644
--- a/src/control-profiles.css
+++ b/src/control-profiles.css
@@ -161,6 +161,7 @@
 
 /* Square icon buttons, matching the segmented controls' border and hover. */
 .icon-button { display:inline-flex;align-items:center;justify-content:center;align-self:center;padding:.34rem;border:1px solid var(--border);border-radius:7px;background:var(--surface-raised);color:var(--text-soft);cursor:pointer;transition:border-color .16s ease,color .16s ease,background .16s ease }
+.icon-button.profile-setup-button { padding:.34rem .75rem;color:var(--ui-accent);font-size:.68rem;font-weight:600;white-space:nowrap }
 .icon-button:hover:not(:disabled) { border-color:var(--ghost);background:var(--surface-hover-soft);color:var(--text-input) }
 .icon-button:disabled { opacity:.45;cursor:not-allowed }
 .icon-button.profile-delete-button { border-color:color-mix(in srgb,var(--destructive) 46%,var(--surface-panel));background:color-mix(in srgb,var(--destructive) 14%,var(--surface-panel));color:color-mix(in srgb,var(--destructive) 76%,var(--text-hover)) }

From 3300c42d330459226f50aac90cdd7eb8727dd9ce Mon Sep 17 00:00:00 2001
From: snekxs <snekxs@users.noreply.github.com>
Date: Mon, 5 Oct 2026 18:16:08 -0600
Subject: [PATCH 4/4] fix(logitech): only offer profile setup where a factory
 image exists
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The Set up profiles button and action were gated on supportsFactoryReset(),
which is also true for profile format 7. Format 7 has no captured factory
sectors, so initializeBlankOnboardProfiles() always threw "Factory profiles
have not been captured for profile format 7" — after the user had already
confirmed a flash write. A format-7 mouse with an empty directory is exactly
the #516 state, so the dead end was reachable, and the new empty-list message
("Where Set up profiles is shown, OpenMouse can create them itself") was false
for those mice.

Move the predicate into src/device/logitech-factory.ts and gate on the captured
factory directory (factoryDirectoryForFormat returns null for every format and
sector size except the captured one), which is what the client itself checks
before writing. Reset keeps supportsFactoryReset, which is the right question
there because the factory profile sectors are what it needs.

Also drop the claim that this is what G HUB does the first time it links a
mouse: the captured sequence is G HUB's reset, and it has not been run against
a never-linked mouse.

Bumps @openmouse/protocol to 0.23.1, which carries the new Logitech API.
tsc --noEmit clean, 269/269 tests (3 new), vite build clean.
---
 package-lock.json                   |  8 ++++----
 package.json                        |  2 +-
 src/device/controller.ts            |  8 +++++---
 src/device/logitech-factory.test.ts | 27 +++++++++++++++++++++++++++
 src/device/logitech-factory.ts      | 23 +++++++++++++++++++++++
 5 files changed, 60 insertions(+), 8 deletions(-)
 create mode 100644 src/device/logitech-factory.test.ts
 create mode 100644 src/device/logitech-factory.ts

diff --git a/package-lock.json b/package-lock.json
index 5f83e79..78b3c74 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -9,7 +9,7 @@
       "version": "2.0.0",
       "license": "AGPL-3.0-or-later",
       "dependencies": {
-        "@openmouse/protocol": "0.23.0",
+        "@openmouse/protocol": "0.23.1",
         "lucide-react": "^1.43.0",
         "preact": "^10.29.8"
       },
@@ -481,9 +481,9 @@
       }
     },
     "node_modules/@openmouse/protocol": {
-      "version": "0.23.0",
-      "resolved": "https://registry.npmjs.org/@openmouse/protocol/-/protocol-0.23.0.tgz",
-      "integrity": "sha512-r41kCnNM/ugSrYo7iuD5Hb6S1tXOGzyLBdfkNY83GTBPvJYhyv44jUHF3jIDpWiRypE5V5wBMIelt6zJQ72fQw==",
+      "version": "0.23.1",
+      "resolved": "https://registry.npmjs.org/@openmouse/protocol/-/protocol-0.23.1.tgz",
+      "integrity": "sha512-CRbE4W/FnE0iaSccYCTwvIcO98SMzZcmYa6oB5foi8DwAhrB72xbVSJpvXkprn0zWEGQQwfLSJRjKcQPeBb91A==",
       "engines": {
         "node": ">=20"
       }
diff --git a/package.json b/package.json
index e35b74d..0bdfef5 100644
--- a/package.json
+++ b/package.json
@@ -13,7 +13,7 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@openmouse/protocol": "0.23.0",
+    "@openmouse/protocol": "0.23.1",
     "lucide-react": "^1.43.0",
     "preact": "^10.29.8"
   },
diff --git a/src/device/controller.ts b/src/device/controller.ts
index 97084ce..74a4bea 100644
--- a/src/device/controller.ts
+++ b/src/device/controller.ts
@@ -101,6 +101,7 @@ import { setCaptureContext } from "../capture-context";
 import {
   decodeProfileKey, encodeProfileKey, profileKeyMatchesDevice, type ProfileKeyPayload,
 } from "./profile-key";
+import { hasCapturedFactoryProfiles } from "./logitech-factory";
 import type { MouseLighting, MouseStatus } from "@openmouse/protocol/drivers/mouse-types";
 import type { KsnakeMacroProfile } from "@openmouse/protocol/ksnake";
 import {
@@ -551,7 +552,7 @@ function buildSnapshot(): ControlSnapshot {
       && supportsFactoryReset(latestDeviceStatus?.onboardProfileFormat?.id ?? null),
     setupProfilesAvailable: logitechClient() !== null
       && latestDeviceStatus?.brand === "Logitech"
-      && supportsFactoryReset(latestDeviceStatus?.onboardProfileFormat?.id ?? null)
+      && hasCapturedFactoryProfiles(latestDeviceStatus?.onboardProfileFormat)
       && onboardProfiles !== null
       && onboardProfiles.length === 0,
     previewMode,
@@ -4031,12 +4032,13 @@ export async function resetLogitechProfiles(): Promise<void> {
 export async function setUpLogitechProfiles(): Promise<void> {
   if (blockedByGameProfileDraft()) return;
   const client = logitechClient();
-  if (!client || settingInProgress || !supportsFactoryReset(lastProfileFormat?.id)) return;
+  if (!client || settingInProgress || !hasCapturedFactoryProfiles(lastProfileFormat)) return;
   if (onboardProfiles === null || onboardProfiles.length > 0) return;
 
   const confirmed = window.confirm(
     "This mouse has no onboard profiles yet.\n\n"
-    + "Set them up now? OpenMouse will write the Logitech factory profiles into the mouse's memory, with profile 1 active. This is what G HUB does the first time it links a mouse, so G HUB is not needed first.",
+    + "Set them up now? OpenMouse will write the Logitech factory profiles into the mouse's memory, with profile 1 active, without G HUB having to link it first.\n\n"
+    + "This replays the sequence captured from G HUB's own reset. It has not been confirmed on a mouse G HUB has never linked.",
   );
   if (!confirmed) return;
 
diff --git a/src/device/logitech-factory.test.ts b/src/device/logitech-factory.test.ts
new file mode 100644
index 0000000..594936d
--- /dev/null
+++ b/src/device/logitech-factory.test.ts
@@ -0,0 +1,27 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import type { MouseStatus } from "@openmouse/protocol/drivers/mouse-types";
+import { hasCapturedFactoryProfiles } from "./logitech-factory.ts";
+
+function format(id: number): NonNullable<MouseStatus["onboardProfileFormat"]> {
+  return { id, name: `format ${id}`, base: "0x8100", supported: true, verified: true, writable: true };
+}
+
+test("only the captured profile format is offered a factory setup", () => {
+  assert.equal(hasCapturedFactoryProfiles(format(8)), true);
+});
+
+test("a format whose factory sectors were never captured is not offered one", () => {
+  // Format 7 passes supportsFactoryReset(), which is what the button used to be
+  // gated on: a PRO X Superlight 2 with no profiles offered the button and then
+  // threw "Factory profiles have not been captured for profile format 7" after
+  // the user had already confirmed a flash write.
+  assert.equal(hasCapturedFactoryProfiles(format(7)), false);
+  assert.equal(hasCapturedFactoryProfiles(format(6)), false);
+});
+
+test("an unknown or unread format is not offered a factory setup", () => {
+  assert.equal(hasCapturedFactoryProfiles(null), false);
+  assert.equal(hasCapturedFactoryProfiles(undefined), false);
+});
diff --git a/src/device/logitech-factory.ts b/src/device/logitech-factory.ts
new file mode 100644
index 0000000..7ed6779
--- /dev/null
+++ b/src/device/logitech-factory.ts
@@ -0,0 +1,23 @@
+import { factoryDirectoryForFormat } from "@openmouse/protocol/drivers/logitech/onboard-profiles";
+import type { MouseStatus } from "@openmouse/protocol/drivers/mouse-types";
+
+/** The sector size of the only factory image captured so far (format 8). */
+const CAPTURED_FACTORY_SECTOR_SIZE = 255;
+
+/**
+ * Whether OpenMouse can give this mouse the factory onboard profiles. A factory
+ * image exists only for the profile format whose sectors were captured:
+ * `factoryDirectoryForFormat` returns null for every other format and sector
+ * size. `supportsFactoryReset` is the wrong question here because it is also true
+ * for profile format 7, whose factory sectors were never captured — the client
+ * would then refuse after the user had already confirmed a flash write.
+ *
+ * The client re-checks the mouse's own sector size before it writes, so this only
+ * decides whether the button is offered at all.
+ */
+export function hasCapturedFactoryProfiles(
+  format: MouseStatus["onboardProfileFormat"] | null | undefined,
+): boolean {
+  return format != null
+    && factoryDirectoryForFormat(format.id, CAPTURED_FACTORY_SECTOR_SIZE) !== null;
+}