From 8c414e6d2517a4a545e17dbba600d0526efb8cf2 Mon Sep 17 00:00:00 2001
From: Nethmina Yasas <63988674+NethminaYasas@users.noreply.github.com>
Date: Mon, 12 Oct 2026 18:49:00 +0530
Subject: [PATCH] docs(api): regenerate OpenAPI copies and fix host binding
 descriptions

---
 docs/public/openapi.json          | 4 ++--
 frontend/package.json             | 2 +-
 frontend/public/openapi.json      | 2 +-
 frontend/src/generated/schemas.ts | 2 +-
 internal/database/model/model.go  | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/public/openapi.json b/docs/public/openapi.json
index 02800b8d3..66fb8241a 100644
--- a/docs/public/openapi.json
+++ b/docs/public/openapi.json
@@ -1701,13 +1701,13 @@
             "type": "string"
           },
           "clientHostRuleId": {
-            "description": "ClientHostRuleId optionally binds one Host row to this client. When set,\nsubscription generation uses that host alone instead of the inbound's\nhosts. Nil or non-positive means no override.",
+            "description": "ClientHostRuleId is a deprecated read-only alias of ClientHostRuleIds[0].\nNil or non-positive means no override (inbound rule applies).",
             "example": 1,
             "nullable": true,
             "type": "integer"
           },
           "clientHostRuleIds": {
-            "description": "ClientHostRuleIds optionally binds several Host rows to this client.\nThe effective binding is the union of this list and ClientHostRuleId;\neach bound host renders its own link/proxy. Empty means no override.",
+            "description": "ClientHostRuleIds is the canonical per-client host binding; each id renders its own link.\nNil preserves, empty clears; no usable host yields empty subscription for that inbound.",
             "example": [
               1,
               2
diff --git a/frontend/package.json b/frontend/package.json
index 6afc3a5bf..bab490e67 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -29,7 +29,7 @@
   },
   "lint-staged": {
     "src/**/*.{ts,tsx}": [
-      "oxfmt",
+      "oxfmt --no-error-on-unmatched-pattern",
       "oxlint --fix"
     ]
   },
diff --git a/frontend/public/openapi.json b/frontend/public/openapi.json
index 35596b510..66fb8241a 100644
--- a/frontend/public/openapi.json
+++ b/frontend/public/openapi.json
@@ -1707,7 +1707,7 @@
             "type": "integer"
           },
           "clientHostRuleIds": {
-            "description": "ClientHostRuleIds is the canonical per-client host binding; each id renders its own link.\nNil means omitted (preserve); empty means clear.",
+            "description": "ClientHostRuleIds is the canonical per-client host binding; each id renders its own link.\nNil preserves, empty clears; no usable host yields empty subscription for that inbound.",
             "example": [
               1,
               2
diff --git a/frontend/src/generated/schemas.ts b/frontend/src/generated/schemas.ts
index 86d021155..eb532b46d 100644
--- a/frontend/src/generated/schemas.ts
+++ b/frontend/src/generated/schemas.ts
@@ -1681,7 +1681,7 @@ export const SCHEMAS: Record<string, unknown> = {
         "type": "integer"
       },
       "clientHostRuleIds": {
-        "description": "ClientHostRuleIds is the canonical per-client host binding; each id renders its own link.\nNil means omitted (preserve); empty means clear.",
+        "description": "ClientHostRuleIds is the canonical per-client host binding; each id renders its own link.\nNil preserves, empty clears; no usable host yields empty subscription for that inbound.",
         "example": [
           1,
           2
diff --git a/internal/database/model/model.go b/internal/database/model/model.go
index 9cb8e2726..f698612ec 100644
--- a/internal/database/model/model.go
+++ b/internal/database/model/model.go
@@ -932,7 +932,7 @@ type Client struct {
 	// Nil or non-positive means no override (inbound rule applies).
 	ClientHostRuleId *int `json:"clientHostRuleId,omitempty" example:"1"`
 	// ClientHostRuleIds is the canonical per-client host binding; each id renders its own link.
-	// Nil means omitted (preserve); empty means clear.
+	// Nil preserves, empty clears; no usable host yields empty subscription for that inbound.
 	ClientHostRuleIds []int `json:"clientHostRuleIds,omitempty" example:"[1,2]"`
 	// AllowedIPsByInbound optionally overrides AllowedIPs on a per-inbound
 	// basis, keyed by inbound id. Lets one identity attached to both