most-box 0.2.6 → 0.2.8

package/server/src/core/channelIdentity.js

@@ -1,4 +1,5 @@
 import crypto from 'node:crypto'
+import { normalizeAvatar, normalizeDisplayName } from './shared.js'
 
 export const CHAT_FILE_ROOT = 'chat-file'
 export const TRANSIENT_CHANNEL_TYPES = new Set(['game'])
@@ -8,14 +9,11 @@ export const CHANNEL_CANDIDATE_TTL = 30 * 1000
 const CHANNEL_WRITER_ID_BYTES = 8
 
 export function normalizeChannelDisplayName(input, fallbackAddress = '') {
-  const value = String(input || '').trim()
-  if (value) return value.slice(0, 50)
-  return fallbackAddress ? fallbackAddress.slice(0, 10) : ''
+  return normalizeDisplayName(input, fallbackAddress ? fallbackAddress.slice(0, 10) : '')
 }
 
 export function normalizeChannelAvatar(input) {
-  const value = String(input || '').trim()
-  return value ? value.slice(0, 4096) : ''
+  return normalizeAvatar(input)
 }
 
 export function normalizeChannelId(input) {

package/server/src/core/gameRoom.js

@@ -1,3 +1,15 @@
+import {
+  createEventId,
+  normalizeAddress,
+  normalizeAvatar,
+  normalizeDisplayName,
+  normalizeRoomCode,
+  randomInt,
+  shortAddress,
+} from './shared.js'
+
+export { normalizeAddress } from './shared.js'
+
 export const GAME_CHANNEL_TYPE = 'game'
 export const GAME_EVENT_KIND = 'mostbox.game.event'
 export const GAME_EVENT_VERSION = 1
@@ -12,11 +24,7 @@ export function normalizeGameId(input) {
 }
 
 export function normalizeGameRoomCode(input) {
-  return String(input || '')
-    .trim()
-    .toUpperCase()
-    .replace(/[^A-Z0-9]/g, '')
-    .slice(0, 8)
+  return normalizeRoomCode(input)
 }
 
 export function isValidGameRoomCode(input) {
@@ -166,10 +174,11 @@ export function createPlayerFromPayload(input, messageOrAuthor) {
   const author = message.author
   const address = normalizeAddress(input.address || author)
   if (!address || normalizeAddress(author) !== address) return null
-  const name =
-    String(message.authorName || input.name || '').trim().slice(0, 50) ||
+  const name = normalizeDisplayName(
+    message.authorName || input.name,
     shortAddress(address)
-  const avatar = String(message.avatar || input.avatar || '').trim()
+  )
+  const avatar = normalizeAvatar(message.avatar || input.avatar)
   const publicKey = String(input.publicKey || '').trim()
   const player = {
     address,
@@ -177,7 +186,7 @@ export function createPlayerFromPayload(input, messageOrAuthor) {
     publicKey,
     joinedAt: Number(input.joinedAt || Date.now()),
   }
-  if (avatar) player.avatar = avatar.slice(0, 4096)
+  if (avatar) player.avatar = avatar
   return player
 }
 
@@ -193,11 +202,6 @@ export function normalizeGamePlayer(input) {
   }
 }
 
-export function normalizeAddress(value) {
-  const address = String(value || '').trim()
-  return /^0x[a-fA-F0-9]{40}$/.test(address) ? address.toLowerCase() : ''
-}
-
 function upsertPlayer(players, playerMap, player) {
   const existing = playerMap.get(player.address)
   if (existing) {
@@ -213,32 +217,3 @@ function sortMessages(messages) {
     (a, b) => Number(a.timestamp || 0) - Number(b.timestamp || 0)
   )
 }
-
-function createEventId(prefix) {
-  return `${prefix}_${Date.now()}_${randomHex(4)}`
-}
-
-function randomInt(max) {
-  if (globalThis.crypto?.getRandomValues) {
-    const value = new Uint32Array(1)
-    globalThis.crypto.getRandomValues(value)
-    return value[0] % max
-  }
-  return Math.floor(Math.random() * max)
-}
-
-function randomHex(byteLength) {
-  const bytes = new Uint8Array(byteLength)
-  if (globalThis.crypto?.getRandomValues) {
-    globalThis.crypto.getRandomValues(bytes)
-  } else {
-    for (let i = 0; i < bytes.length; i++) {
-      bytes[i] = Math.floor(Math.random() * 256)
-    }
-  }
-  return [...bytes].map(byte => byte.toString(16).padStart(2, '0')).join('')
-}
-
-function shortAddress(address) {
-  return address ? `${address.slice(0, 6)}...${address.slice(-4)}` : ''
-}

package/server/src/core/ownerMetadata.js

@@ -1,9 +1,8 @@
+import { normalizeAddress } from './shared.js'
+
 export const DEFAULT_OWNER_BUCKET = '__local__'
 
-export function normalizeOwnerAddress(address) {
-  const value = String(address || '').trim()
-  return /^0x[a-fA-F0-9]{40}$/.test(value) ? value.toLowerCase() : ''
-}
+export const normalizeOwnerAddress = normalizeAddress
 
 export function getOwnerBucketKey(address) {
   return normalizeOwnerAddress(address) || DEFAULT_OWNER_BUCKET

package/server/src/core/releaseManifest.js

@@ -0,0 +1,91 @@
+export const RELEASE_PLATFORMS = ['windows', 'macos', 'linux']
+export const RELEASE_ARCHES = ['x64', 'arm64']
+export const RELEASE_ASSET_KINDS = ['installer']
+
+export const RELEASE_TARGETS = Object.freeze([
+  { platform: 'windows', arch: 'x64' },
+  { platform: 'windows', arch: 'arm64' },
+  { platform: 'macos', arch: 'x64' },
+  { platform: 'macos', arch: 'arm64' },
+  { platform: 'linux', arch: 'x64' },
+  { platform: 'linux', arch: 'arm64' },
+])
+
+const RELEASE_PLATFORM_SET = new Set(RELEASE_PLATFORMS)
+const RELEASE_ARCH_SET = new Set(RELEASE_ARCHES)
+const RELEASE_ASSET_KIND_SET = new Set(RELEASE_ASSET_KINDS)
+
+function isRecord(value) {
+  return typeof value === 'object' && value !== null
+}
+
+function isNonEmptyString(value) {
+  return typeof value === 'string' && value.trim().length > 0
+}
+
+function isPositiveFiniteNumber(value) {
+  return Number.isFinite(value) && value > 0
+}
+
+function isOptionalNonEmptyString(value) {
+  return typeof value === 'undefined' || isNonEmptyString(value)
+}
+
+export function isReleaseAsset(value) {
+  if (!isRecord(value)) return false
+
+  return (
+    RELEASE_PLATFORM_SET.has(value.platform) &&
+    RELEASE_ARCH_SET.has(value.arch) &&
+    RELEASE_ASSET_KIND_SET.has(value.kind) &&
+    isNonEmptyString(value.filename) &&
+    isPositiveFiniteNumber(value.size) &&
+    isNonEmptyString(value.cid) &&
+    isNonEmptyString(value.githubUrl) &&
+    isOptionalNonEmptyString(value.r2Url)
+  )
+}
+
+export function isReleaseManifest(value) {
+  if (!isRecord(value)) return false
+  if (!isNonEmptyString(value.version)) return false
+  if (!isNonEmptyString(value.publishedAt)) return false
+  if (!Array.isArray(value.assets)) return false
+
+  return value.assets.every(isReleaseAsset)
+}
+
+export function getReleaseAssetKey(asset) {
+  return `${asset.platform}:${asset.arch}`
+}
+
+export function getInstallerReleaseAssets(manifest) {
+  if (!isReleaseManifest(manifest)) return []
+  return manifest.assets.filter(asset => asset.kind === 'installer')
+}
+
+export function hasR2ReleaseAssets(assets) {
+  if (!Array.isArray(assets)) return false
+  return assets.some(asset => isRecord(asset) && isNonEmptyString(asset.r2Url))
+}
+
+export function resolveReleaseAssetDownload(asset, preferredSource = 'r2') {
+  if (
+    preferredSource === 'r2' &&
+    isRecord(asset) &&
+    isNonEmptyString(asset.r2Url)
+  ) {
+    return {
+      source: 'r2',
+      url: asset.r2Url,
+    }
+  }
+
+  return {
+    source: 'github',
+    url:
+      isRecord(asset) && isNonEmptyString(asset.githubUrl)
+        ? asset.githubUrl
+        : '',
+  }
+}

package/server/src/core/shared.js

@@ -0,0 +1,50 @@
+export function normalizeAddress(value) {
+  const address = String(value || '').trim()
+  return /^0x[a-fA-F0-9]{40}$/.test(address) ? address.toLowerCase() : ''
+}
+
+export function shortAddress(address) {
+  return address ? `${address.slice(0, 6)}...${address.slice(-4)}` : ''
+}
+
+export function normalizeAvatar(value) {
+  return String(value || '').trim().slice(0, 4096)
+}
+
+export function normalizeDisplayName(value, fallback = '', maxLength = 50) {
+  const displayName = String(value || '').trim()
+  return (displayName || String(fallback || '')).slice(0, maxLength)
+}
+
+export function normalizeRoomCode(value) {
+  return String(value || '')
+    .trim()
+    .toUpperCase()
+    .replace(/[^A-Z0-9]/g, '')
+    .slice(0, 8)
+}
+
+export function createEventId(prefix) {
+  return `${prefix}_${Date.now()}_${randomHex(4)}`
+}
+
+export function randomInt(max) {
+  if (globalThis.crypto?.getRandomValues) {
+    const value = new Uint32Array(1)
+    globalThis.crypto.getRandomValues(value)
+    return value[0] % max
+  }
+  return Math.floor(Math.random() * max)
+}
+
+export function randomHex(byteLength) {
+  const bytes = new Uint8Array(byteLength)
+  if (globalThis.crypto?.getRandomValues) {
+    globalThis.crypto.getRandomValues(bytes)
+  } else {
+    for (let i = 0; i < bytes.length; i++) {
+      bytes[i] = Math.floor(Math.random() * 256)
+    }
+  }
+  return [...bytes].map(byte => byte.toString(16).padStart(2, '0')).join('')
+}

package/server/src/core/zhajinhua.js

@@ -1,3 +1,11 @@
+import {
+  createEventId as createSharedEventId,
+  normalizeAddress,
+  normalizeAvatar,
+  normalizeRoomCode as normalizeSharedRoomCode,
+  shortAddress,
+} from './shared.js'
+
 export const ZHJ_INITIAL_CHIPS = 1000
 export const ZHJ_ANTE = 10
 export const ZHJ_MIN_PLAYERS = 2
@@ -28,15 +36,11 @@ const CATEGORY_LABEL = {
 }
 
 export function normalizeRoomCode(input) {
-  return String(input || '')
-    .trim()
-    .toUpperCase()
-    .replace(/[^A-Z0-9]/g, '')
-    .slice(0, 8)
+  return normalizeSharedRoomCode(input)
 }
 
 export function createEventId(prefix = 'zhajinhua') {
-  return `${prefix}_${Date.now()}_${randomHex(4)}`
+  return createSharedEventId(prefix)
 }
 
 export function createRoundId() {
@@ -196,7 +200,7 @@ export function startRound({ roomCode, players, hostAddress, previousSeq = 0, pr
     return {
       address: player.address,
       name: player.name,
-      avatar: cleanAvatar(player.avatar),
+      avatar: normalizeAvatar(player.avatar),
       publicKey: player.publicKey,
       chips: Number(player.chips) - ZHJ_ANTE,
       status: 'active',
@@ -598,7 +602,7 @@ function normalizeRoundPlayer(input) {
   return {
     address,
     name: String(input.name || shortAddress(address)).slice(0, 50),
-    avatar: cleanAvatar(input.avatar),
+    avatar: normalizeAvatar(input.avatar),
     publicKey: String(input.publicKey || ''),
     chips: Math.max(0, Number(input.chips) || 0),
     status: input.status === 'folded' ? 'folded' : 'active',
@@ -607,31 +611,6 @@ function normalizeRoundPlayer(input) {
   }
 }
 
-function normalizeAddress(value) {
-  const address = String(value || '').trim()
-  return /^0x[a-fA-F0-9]{40}$/.test(address) ? address.toLowerCase() : ''
-}
-
-function shortAddress(address) {
-  return address ? `${address.slice(0, 6)}...${address.slice(-4)}` : ''
-}
-
-function cleanAvatar(value) {
-  return String(value || '').trim().slice(0, 4096)
-}
-
 function clone(value) {
   return JSON.parse(JSON.stringify(value))
 }
-
-function randomHex(byteLength) {
-  const bytes = new Uint8Array(byteLength)
-  if (globalThis.crypto?.getRandomValues) {
-    globalThis.crypto.getRandomValues(bytes)
-  } else {
-    for (let i = 0; i < bytes.length; i++) {
-      bytes[i] = Math.floor(Math.random() * 256)
-    }
-  }
-  return [...bytes].map(byte => byte.toString(16).padStart(2, '0')).join('')
-}

package/server/src/games/gandengyan.js

@@ -1,3 +1,5 @@
+import { normalizeAddress, normalizeAvatar } from '../core/shared.js'
+
 const SUITS = ['S', 'H', 'C', 'D']
 const RANKS = ['3', '4', '5', '6', '7', '8', '9', '10', 'J', 'Q', 'K', 'A', '2']
 const STRAIGHT_RANKS = RANKS.filter(rank => rank !== '2')
@@ -30,7 +32,7 @@ export function createGanDengYanRoom({
     players: roomPlayers.slice(0, 6).map((player, seat) => ({
       address: player.address,
       name: cleanName(player.name),
-      avatar: cleanAvatar(player.avatar),
+      avatar: normalizeAvatar(player.avatar),
       seat,
       hand: [],
       handCount: 0,
@@ -64,7 +66,7 @@ export function syncGanDengYanLobby(room, players = []) {
     .map((player, seat) => ({
       address: player.address,
       name: cleanName(player.name),
-      avatar: cleanAvatar(player.avatar),
+      avatar: normalizeAvatar(player.avatar),
       seat,
       hand: [],
       handCount: 0,
@@ -260,7 +262,7 @@ export function publicGanDengYanRoom(room) {
     players: orderedPlayers(room).map(player => ({
       address: player.address,
       name: player.name,
-      avatar: cleanAvatar(player.avatar),
+      avatar: normalizeAvatar(player.avatar),
       seat: player.seat,
       handCount: player.hand?.length ?? player.handCount ?? 0,
       score: Number(player.score ?? INITIAL_SCORE),
@@ -435,7 +437,7 @@ function normalizePlayers(players) {
     .map(player => ({
       address: normalizeAddress(player.address),
       name: cleanName(player.name),
-      avatar: cleanAvatar(player.avatar),
+      avatar: normalizeAvatar(player.avatar),
       publicKey: String(player.publicKey || ''),
     }))
     .filter(player => {
@@ -451,7 +453,7 @@ function normalizeRoundPlayer(input) {
   return {
     address,
     name: cleanName(input.name),
-    avatar: cleanAvatar(input.avatar),
+    avatar: normalizeAvatar(input.avatar),
     seat: Number(input.seat || 0),
     hand: Array.isArray(input.hand) ? input.hand.map(normalizeCard).filter(Boolean) : [],
     handCount: Number(input.handCount || 0),
@@ -677,15 +679,6 @@ function rollDice(random) {
   return Math.floor(random() * 6) + 1
 }
 
-function normalizeAddress(value) {
-  const address = String(value || '').trim()
-  return /^0x[a-fA-F0-9]{40}$/.test(address) ? address.toLowerCase() : ''
-}
-
 function cleanName(name) {
   return String(name || '玩家').trim().slice(0, 16) || '玩家'
 }
-
-function cleanAvatar(avatar) {
-  return String(avatar || '').trim().slice(0, 4096)
-}

package/server/src/http/nodeStatus.js

@@ -260,12 +260,6 @@ export function buildOpenApiSpec(appPort) {
           responses: { 200: { description: 'Created channel message' } },
         },
       },
-      '/api/channels/{name}/members': {
-        get: {
-          summary: 'List P2P channel members',
-          responses: { 200: { description: 'Channel members' } },
-        },
-      },
       '/api/channels/{name}/peers': {
         get: {
           summary: 'List currently connected channel peers',

package/server/src/http/routes/channelRoutes.js

@@ -1,4 +1,4 @@
-import { normalizeAddress } from '../../utils/auth.js'
+import { normalizeAddress } from '../../core/shared.js'
 import { badRequestOrAppError } from '../errors.js'
 
 export function registerChannelRoutes(app, { engine }) {
@@ -72,18 +72,6 @@ export function registerChannelRoutes(app, { engine }) {
     }
   })
 
-  app.get('/api/channels/:name/members', c => {
-    try {
-      return c.json(
-        engine.getChannelMembers(c.req.param('name'), {
-          ownerAddress: c.get('userAddress'),
-        })
-      )
-    } catch (err) {
-      return badRequestOrAppError(c, err)
-    }
-  })
-
   app.post('/api/channels/:name/messages', async c => {
     const name = c.req.param('name')
     const body = await c.req.json()

package/server/src/http/routes/nodeRoutes.js

@@ -1,4 +1,4 @@
-import { normalizeAddress } from '../../utils/auth.js'
+import { normalizeAddress } from '../../core/shared.js'
 import { evaluateStorageLimits } from '../../node/config.js'
 import {
   isLoopbackRemoteAddress,