Document generated plugin user names

docs/PLUGIN_AUTHOR_GUIDE.md

@@ -371,7 +371,7 @@ Each method requires the matching permission in your manifest:
 | `owncast.users.list()` / `.get(id)`                                             | `users.read`         |
 | `owncast.users.setEnabled(id, enabled, reason?)`                                | `users.moderate`     |
 | `owncast.users.banIP(ip)`                                                       | `users.moderate`     |
-| `owncast.users.register({authId, displayName?, scopes?, profileUrl?, handle?, public?})` | `users.register` |
+| `owncast.users.register({authId, displayName?: string \| null, scopes?, profileUrl?, handle?, public?})` | `users.register` |
 | `owncast.auth.grantSession({userId, ttl?})` / `owncast.auth.endSession()`       | `auth.gate`          |
 | `owncast.kv.get(key)` / `.set(key, value)` (+ `.getJSON` / `.setJSON`)          | `storage.kv`         |
 | `owncast.storage.upload(name, bytes)`, returns `{url}`                          | `storage.upload`     |
@@ -834,11 +834,12 @@ return { status: 302, headers: { Location: returnTo } };
 
 `users.register` finds or creates an authenticated Owncast user for an external
 identity. The host scopes `authId` to your slug, so pass the provider's raw
-stable ID. `profileUrl` must be empty or an absolute HTTP(S) URL. Set `handle`
-to the verified provider label and set `public` true only after the viewer opts
-into public display. `grantSession` and `endSession` are meaningful only inside
-`onHttpRequest`, where the host attaches or clears the cookie after the handler
-returns.
+stable ID. `displayName` is optional. Omit it or pass `null` to generate a
+display name. `profileUrl` must be empty or an absolute HTTP(S) URL. Set
+`handle` to the verified provider label and set `public` true only after the
+viewer opts into public display. `grantSession` and `endSession` are meaningful
+only inside `onHttpRequest`, where the host attaches or clears the cookie after
+the handler returns.
 
 ### Re-validating sessions: `onAuthCheck`
 

docs/WIRE_PROTOCOL.md

@@ -291,6 +291,9 @@ authentication gate uses this before granting a session.
   as the unmodified provider-specific ID. The host rejects administrative or
   otherwise disallowed scopes.
 
+  `displayName` is optional and nullable. When omitted or `null`, the host generates
+  the user's display name.
+
 ### `auth.gate`
 
 Only one `auth.gate` plugin can be enabled at a time. These calls are meaningful
@@ -745,7 +748,7 @@ type CommandEvent = {
 
 type UserRegisterRequest = {
   authId: string;
-  displayName?: string;
+  displayName?: string | null;
   scopes?: string[];
   profileUrl?: string;
   handle?: string;

host-runtime/go.mod

@@ -5,7 +5,7 @@ go 1.26.2
 require (
 	github.com/extism/go-sdk v1.7.1
 	github.com/gobwas/glob v0.2.3
-	github.com/owncast/owncast v0.2.6-0.20260803201111-10d12cba1ffb
+	github.com/owncast/owncast v0.2.6-0.20260804005024-a1ee0743079c
 	modernc.org/sqlite v1.53.0
 )
 

host-runtime/go.sum

@@ -24,8 +24,8 @@ github.com/mattn/go-sqlite3 v1.14.47 h1:jOBI62gS7nKeZv+as1oGEy0+1qISgXwH/QBlR6Kb
 github.com/mattn/go-sqlite3 v1.14.47/go.mod h1:6JTjA44L93a0QCyJef5YvlPoKXntQPjzWv5gtm9sB6w=
 github.com/ncruces/go-strftime v1.0.0 h1:HMFp8mLCTPp341M/ZnA4qaf7ZlsbTc+miZjCLOFAw7w=
 github.com/ncruces/go-strftime v1.0.0/go.mod h1:Fwc5htZGVVkseilnfgOVb9mKy6w1naJmn9CehxcKcls=
-github.com/owncast/owncast v0.2.6-0.20260803201111-10d12cba1ffb h1:v28vfyeK0/0hsjLA4Xju/pkeu/2wyuGRfwnn+K+DomU=
-github.com/owncast/owncast v0.2.6-0.20260803201111-10d12cba1ffb/go.mod h1:/pBiqGTab5UMn37wapn4zzpQUG2476ayj/zlsyJMcgA=
+github.com/owncast/owncast v0.2.6-0.20260804005024-a1ee0743079c h1:RUnvkPsZ9PzQB/jhvtV/VezkpSETXRsfqHfYw1l9/Bo=
+github.com/owncast/owncast v0.2.6-0.20260804005024-a1ee0743079c/go.mod h1:/pBiqGTab5UMn37wapn4zzpQUG2476ayj/zlsyJMcgA=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
 github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE=

sdks/js/index.d.ts

@@ -212,8 +212,8 @@ export const Permissions: {
 export interface UserRegisterRequest {
   /** Stable external identity within this plugin's provider namespace. */
   authId: string;
-  /** Optional display name to seed on the user. */
-  displayName?: string;
+  /** Optional display name to seed on the user. Omit or pass `null` to generate one. */
+  displayName?: string | null;
   /** Optional scopes to grant the user (e.g. `["MODERATOR"]`). */
   scopes?: string[];
   /** Verified public profile URL. The host accepts only absolute HTTP(S) URLs. */

sdks/python/owncast_plugin/__init__.py

@@ -655,10 +655,11 @@ def register(
     ):
         """Find or create an authenticated user for an external identity.
 
-        auth_id is the stable, provider-scoped ID. profile_url and handle
-        describe a verified external profile. Set public=True only when the
-        viewer agreed to show that identity publicly. Returns an object with
-        .user_id. Raises on host error. Requires 'users.register'.
+        auth_id is the stable, provider-scoped ID. Omit display_name or pass
+        None to have Owncast generate one. profile_url and handle describe a
+        verified external profile. Set public=True only when the viewer agreed
+        to show that identity publicly. Returns an object with .user_id. Raises
+        on host error. Requires 'users.register'.
         """
         req = {"authId": str(auth_id)}
         if display_name is not None: