@volter/world-core 3.0.160 → 3.0.161

package/dist/generated/pack-facts.json

@@ -1662,7 +1662,16 @@
           "LIVEKIT_API_SECRET": "twin-livekit-secret-for-the-worlds-own-server"
         },
         "note": "Credentials and URL are the same ones the World starts its LiveKit server with."
-      }
+      },
+      "sidePorts": [
+        {
+          "name": "rtc-tcp",
+          "option": "rtcTcpPort",
+          "flag": "--rtc-tcp-port",
+          "scheme": "tcp",
+          "note": "ICE/TCP media advertised on loopback at this port; the vendor binds all interfaces. Forward beside signaling for a browser on another machine."
+        }
+      ]
     },
     "merge": {
       "adoption": {
@@ -3045,6 +3054,102 @@
       },
       "serveExport": "createTurbopufferTwinServer"
     },
+    "twitch": {
+      "adoption": {
+        "sdks": [],
+        "envStems": [
+          "TWITCH"
+        ]
+      },
+      "hosts": [
+        {
+          "host": "api.twitch.tv",
+          "pathPattern": "^/helix/|^/_twin/"
+        },
+        {
+          "host": "id.twitch.tv",
+          "pathPattern": "^/oauth2/|^/_twin/"
+        },
+        {
+          "host": "www.twitch.tv",
+          "pathPattern": "^/$|^/login/?$|^/popout/[A-Za-z0-9_]{1,25}/chat/?$|^/[A-Za-z0-9_]{1,25}/?$|^/_twin/"
+        },
+        {
+          "host": "twitch.tv",
+          "pathPattern": "^/$|^/login/?$|^/popout/[A-Za-z0-9_]{1,25}/chat/?$|^/[A-Za-z0-9_]{1,25}/?$|^/_twin/"
+        },
+        {
+          "host": "m.twitch.tv",
+          "pathPattern": "^/$|^/login/?$|^/popout/[A-Za-z0-9_]{1,25}/chat/?$|^/[A-Za-z0-9_]{1,25}/?$|^/_twin/"
+        },
+        {
+          "host": "dashboard.twitch.tv",
+          "pathPattern": "^/u/[A-Za-z0-9_]{1,25}/(?:stream-manager|settings/stream)/?$"
+        },
+        {
+          "host": "player.twitch.tv",
+          "pathPattern": "^/$"
+        },
+        {
+          "host": "irc-ws.chat.twitch.tv"
+        },
+        {
+          "host": "usher.ttvnw.net",
+          "pathPattern": "^/api/channel/hls/"
+        }
+      ],
+      "archetype": "crud",
+      "protocol": {
+        "declared": "3",
+        "major": 3,
+        "standing": "current"
+      },
+      "transport": "rest",
+      "resources": [
+        "user",
+        "channel",
+        "stream",
+        "chat_message",
+        "application",
+        "_token",
+        "_authorization_code",
+        "_client_secret",
+        "_stream_key",
+        "_live",
+        "_live_segment"
+      ],
+      "endpointEnvNone": "Twitch's clients address api.twitch.tv, id.twitch.tv and irc-ws.chat.twitch.tv by their published URLs; no SDK reads a base-URL variable",
+      "credentialDoor": {
+        "path": "/_twin/console",
+        "body": {
+          "login": "worldchannel",
+          "password": "world-password",
+          "email": "worldchannel@example.com",
+          "application": {
+            "name": "World App",
+            "redirect_uris": [
+              "http://localhost:3000"
+            ]
+          }
+        },
+        "fill": {
+          "TWITCH_CLIENT_ID": "client_id",
+          "TWITCH_CLIENT_SECRET": "client_secret",
+          "TWITCH_CHANNEL": "login"
+        }
+      },
+      "sidePorts": [
+        {
+          "name": "ingest",
+          "option": "ingestPort",
+          "flag": "--ingest-port",
+          "scheme": "rtmp",
+          "path": "/app",
+          "note": "Twitch's RTMP ingest (rtmp://<ingest-server>/app/<stream-key>): OBS publishes the channel's broadcast here"
+        }
+      ],
+      "serveExport": "createTwitchTwinServer"
+    },
     "upstash": {
       "adoption": {
         "sdks": [

package/dist/src/live/rtmp.js

@@ -198,6 +198,9 @@ export function rtmpSession(sink, publisher, log = () => { }) {
         catch (error) {
             if (!(error instanceof RtmpRefusal))
                 throw error;
+            // said in the World's log too, not only to the publisher: an ended broadcast is otherwise unreadable afterwards
+            // (the stream key is the publish name, so it is never logged)
+            log(`a publish to ${app || 'its app'} was refused and ended: ${error.message}`);
             status(publishStream, 'error', error.code, error.message);
             await stop();
             close();

package/generated/pack-facts.json

@@ -1662,7 +1662,16 @@
           "LIVEKIT_API_SECRET": "twin-livekit-secret-for-the-worlds-own-server"
         },
         "note": "Credentials and URL are the same ones the World starts its LiveKit server with."
-      }
+      },
+      "sidePorts": [
+        {
+          "name": "rtc-tcp",
+          "option": "rtcTcpPort",
+          "flag": "--rtc-tcp-port",
+          "scheme": "tcp",
+          "note": "ICE/TCP media advertised on loopback at this port; the vendor binds all interfaces. Forward beside signaling for a browser on another machine."
+        }
+      ]
     },
     "merge": {
       "adoption": {
@@ -3045,6 +3054,102 @@
       },
       "serveExport": "createTurbopufferTwinServer"
     },
+    "twitch": {
+      "adoption": {
+        "sdks": [],
+        "envStems": [
+          "TWITCH"
+        ]
+      },
+      "hosts": [
+        {
+          "host": "api.twitch.tv",
+          "pathPattern": "^/helix/|^/_twin/"
+        },
+        {
+          "host": "id.twitch.tv",
+          "pathPattern": "^/oauth2/|^/_twin/"
+        },
+        {
+          "host": "www.twitch.tv",
+          "pathPattern": "^/$|^/login/?$|^/popout/[A-Za-z0-9_]{1,25}/chat/?$|^/[A-Za-z0-9_]{1,25}/?$|^/_twin/"
+        },
+        {
+          "host": "twitch.tv",
+          "pathPattern": "^/$|^/login/?$|^/popout/[A-Za-z0-9_]{1,25}/chat/?$|^/[A-Za-z0-9_]{1,25}/?$|^/_twin/"
+        },
+        {
+          "host": "m.twitch.tv",
+          "pathPattern": "^/$|^/login/?$|^/popout/[A-Za-z0-9_]{1,25}/chat/?$|^/[A-Za-z0-9_]{1,25}/?$|^/_twin/"
+        },
+        {
+          "host": "dashboard.twitch.tv",
+          "pathPattern": "^/u/[A-Za-z0-9_]{1,25}/(?:stream-manager|settings/stream)/?$"
+        },
+        {
+          "host": "player.twitch.tv",
+          "pathPattern": "^/$"
+        },
+        {
+          "host": "irc-ws.chat.twitch.tv"
+        },
+        {
+          "host": "usher.ttvnw.net",
+          "pathPattern": "^/api/channel/hls/"
+        }
+      ],
+      "archetype": "crud",
+      "protocol": {
+        "declared": "3",
+        "major": 3,
+        "standing": "current"
+      },
+      "transport": "rest",
+      "resources": [
+        "user",
+        "channel",
+        "stream",
+        "chat_message",
+        "application",
+        "_token",
+        "_authorization_code",
+        "_client_secret",
+        "_stream_key",
+        "_live",
+        "_live_segment"
+      ],
+      "endpointEnvNone": "Twitch's clients address api.twitch.tv, id.twitch.tv and irc-ws.chat.twitch.tv by their published URLs; no SDK reads a base-URL variable",
+      "credentialDoor": {
+        "path": "/_twin/console",
+        "body": {
+          "login": "worldchannel",
+          "password": "world-password",
+          "email": "worldchannel@example.com",
+          "application": {
+            "name": "World App",
+            "redirect_uris": [
+              "http://localhost:3000"
+            ]
+          }
+        },
+        "fill": {
+          "TWITCH_CLIENT_ID": "client_id",
+          "TWITCH_CLIENT_SECRET": "client_secret",
+          "TWITCH_CHANNEL": "login"
+        }
+      },
+      "sidePorts": [
+        {
+          "name": "ingest",
+          "option": "ingestPort",
+          "flag": "--ingest-port",
+          "scheme": "rtmp",
+          "path": "/app",
+          "note": "Twitch's RTMP ingest (rtmp://<ingest-server>/app/<stream-key>): OBS publishes the channel's broadcast here"
+        }
+      ],
+      "serveExport": "createTwitchTwinServer"
+    },
     "upstash": {
       "adoption": {
         "sdks": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/world-core",
-  "version": "3.0.160",
+  "version": "3.0.161",
   "description": "The kernel of Volter World: one log per twin, branches as pointers, checkpoints, the fold that keeps a twin current, the head that performs a write against the vendor, references, and the git plane. A twin package builds on it; the runtime serves it.",
   "keywords": [
     "twin",
@@ -182,5 +182,13 @@
   },
   "optionalDependencies": {
     "@xmldom/xmldom": "0.9.12"
+  },
+  "packageManager": "pnpm@12.15.0",
+  "devEngines": {
+    "packageManager": {
+      "name": "pnpm",
+      "version": "12.15.0",
+      "onFail": "error"
+    }
   }
 }

package/src/live/rtmp.ts

@@ -204,6 +204,9 @@ export function rtmpSession(sink: TwinStreamSink, publisher: RtmpPublisher, log:
   const media = async (hand: () => void | Promise<void>): Promise<void> => {
     try { await hand(); } catch (error) {
       if (!(error instanceof RtmpRefusal)) throw error;
+      // said in the World's log too, not only to the publisher: an ended broadcast is otherwise unreadable afterwards
+      // (the stream key is the publish name, so it is never logged)
+      log(`a publish to ${app || 'its app'} was refused and ended: ${error.message}`);
       status(publishStream, 'error', error.code, error.message);
       await stop();
       close();