@ray-js/robot-map-sdk 0.0.9 → 0.0.11

package/bin/docs-server.js

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+
+import { createServer } from 'node:http'
+import { readFile, stat } from 'node:fs/promises'
+import { dirname, extname, join, normalize } from 'node:path'
+import process from 'node:process'
+import { fileURLToPath } from 'node:url'
+
+const MIME_TYPES = {
+  '.html': 'text/html; charset=utf-8',
+  '.css': 'text/css; charset=utf-8',
+  '.js': 'application/javascript; charset=utf-8',
+  '.mjs': 'application/javascript; charset=utf-8',
+  '.json': 'application/json; charset=utf-8',
+  '.svg': 'image/svg+xml',
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+  '.gif': 'image/gif',
+  '.webp': 'image/webp',
+  '.ico': 'image/x-icon',
+  '.txt': 'text/plain; charset=utf-8',
+  '.woff': 'font/woff',
+  '.woff2': 'font/woff2',
+}
+
+const HELP_TEXT = `
+Usage:
+  robot-map-docs [--host <host>] [--port <port>]
+
+Options:
+  --host, -H    Host to bind (default: 127.0.0.1)
+  --port, -p    Port to listen on (default: 4173)
+  --help, -h    Show this help message
+`
+
+const parseArgs = (argv) => {
+  let host = '127.0.0.1'
+  let port = 4173
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i]
+    const next = argv[i + 1]
+
+    if (arg === '--help' || arg === '-h') {
+      console.log(HELP_TEXT.trim())
+      process.exit(0)
+    }
+
+    if ((arg === '--host' || arg === '-H') && next) {
+      host = next
+      i += 1
+      continue
+    }
+
+    if ((arg === '--port' || arg === '-p') && next) {
+      const parsed = Number.parseInt(next, 10)
+      if (Number.isNaN(parsed) || parsed <= 0) {
+        throw new Error(`Invalid port: ${next}`)
+      }
+      port = parsed
+      i += 1
+      continue
+    }
+  }
+
+  return { host, port }
+}
+
+const getSafePath = (rawPathname) => {
+  const decoded = decodeURIComponent(rawPathname)
+  const trimmed = decoded.replace(/^\/+/, '')
+  const normalized = normalize(trimmed)
+
+  if (
+    normalized === '..' ||
+    normalized.startsWith('../') ||
+    normalized.startsWith('..\\')
+  ) {
+    return null
+  }
+
+  return normalized
+}
+
+const currentFile = fileURLToPath(import.meta.url)
+const currentDir = dirname(currentFile)
+const docsRoot = join(currentDir, '..', 'dist-docs')
+
+const serveFile = async (filePath, response) => {
+  const content = await readFile(filePath)
+  const ext = extname(filePath).toLowerCase()
+  const contentType = MIME_TYPES[ext] ?? 'application/octet-stream'
+  response.writeHead(200, {
+    'Content-Type': contentType,
+    'Cache-Control':
+      ext === '.html' ? 'no-store' : 'public, max-age=31536000, immutable',
+  })
+  response.end(content)
+}
+
+const createRequestHandler = () => async (request, response) => {
+  try {
+    const url = new URL(request.url ?? '/', 'http://localhost')
+    const pathname = url.pathname === '/' ? '/index.html' : url.pathname
+    const safePath = getSafePath(pathname)
+
+    if (!safePath) {
+      response.writeHead(400, { 'Content-Type': 'text/plain; charset=utf-8' })
+      response.end('Bad request path')
+      return
+    }
+
+    const candidateFile = join(docsRoot, safePath)
+
+    try {
+      const fileStat = await stat(candidateFile)
+      if (fileStat.isFile()) {
+        await serveFile(candidateFile, response)
+        return
+      }
+    } catch (error) {
+      if (!(error instanceof Error) || !('code' in error)) {
+        throw error
+      }
+    }
+
+    if (!extname(safePath)) {
+      const nestedIndex = join(docsRoot, safePath, 'index.html')
+      try {
+        const nestedStat = await stat(nestedIndex)
+        if (nestedStat.isFile()) {
+          await serveFile(nestedIndex, response)
+          return
+        }
+      } catch (error) {
+        if (!(error instanceof Error) || !('code' in error)) {
+          throw error
+        }
+      }
+    }
+
+    if (!extname(safePath)) {
+      await serveFile(join(docsRoot, 'index.html'), response)
+      return
+    }
+
+    response.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' })
+    response.end('Not found')
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error)
+    response.writeHead(500, { 'Content-Type': 'text/plain; charset=utf-8' })
+    response.end(`Internal server error: ${message}`)
+  }
+}
+
+const main = async () => {
+  const { host, port } = parseArgs(process.argv.slice(2))
+
+  try {
+    const rootStat = await stat(docsRoot)
+    if (!rootStat.isDirectory()) {
+      throw new Error('dist-docs is not a directory')
+    }
+  } catch (error) {
+    if (error instanceof Error) {
+      const maybeCode =
+        typeof error === 'object' && error && 'code' in error
+          ? error.code
+          : undefined
+      if (String(maybeCode ?? '') !== 'ENOENT') {
+        console.warn(
+          `[robot-map-docs] docs root check warning: ${error.message}`,
+        )
+      }
+    }
+    console.error(
+      '[robot-map-docs] dist-docs not found. Please build docs before publish.',
+    )
+    process.exit(1)
+  }
+
+  const server = createServer(createRequestHandler())
+  server.listen(port, host, () => {
+    console.log(
+      `[robot-map-docs] Serving dist-docs at http://${host}:${String(port)}`,
+    )
+  })
+}
+
+main().catch((error) => {
+  const message = error instanceof Error ? error.message : String(error)
+  console.error(`[robot-map-docs] Failed to start: ${message}`)
+  process.exit(1)
+})