@realsee/vr-cli 0.1.4 → 0.2.0

package/templates/base/server/work-route.ts

@@ -5,6 +5,7 @@ const RESOURCE_CODE_PATTERN = '^[A-Za-z0-9_-]{1,128}$'
 
 export interface WorkRoutesOptions {
   readonly workService: WorkService
+  readonly defaultResourceCode: string | undefined
 }
 
 interface WorkRouteParams {
@@ -23,9 +24,56 @@ const upstreamStatusCode = (error: unknown): number => {
 
 export function workRoutes(
   app: FastifyInstance,
-  { workService }: WorkRoutesOptions,
+  { workService, defaultResourceCode }: WorkRoutesOptions,
   done: (error?: Error) => void,
 ): void {
+  const getWork = async (
+    request: FastifyRequest,
+    reply: FastifyReply,
+    resourceCode: string,
+  ): Promise<WorkEnvelope | FastifyReply> => {
+    const requestAbort = new AbortController()
+    const abortDisconnectedRequest = (): void => {
+      if (request.raw.aborted || !request.raw.complete) requestAbort.abort()
+    }
+    request.raw.once('close', abortDisconnectedRequest)
+
+    try {
+      return await workService.getWorkByResourceCode(resourceCode, {
+        signal: requestAbort.signal,
+      })
+    } catch (error) {
+      const statusCode = upstreamStatusCode(error)
+      request.log.error({ err: error }, 'Work BFF request failed')
+      return reply.code(statusCode).send({
+        error:
+          statusCode === 404
+            ? 'WORK_NOT_FOUND'
+            : statusCode === 504
+              ? 'WORK_UPSTREAM_TIMEOUT'
+              : 'WORK_UPSTREAM_FAILED',
+        requestId: request.id,
+      })
+    } finally {
+      request.raw.off('close', abortDisconnectedRequest)
+    }
+  }
+
+  app.get(
+    '/api/work',
+    async (request, reply): Promise<WorkEnvelope | FastifyReply> => {
+      if (!defaultResourceCode) {
+        return reply.code(400).send({
+          error: 'RESOURCE_CODE_REQUIRED',
+          message:
+            'Provide resourceCode at /api/work/{resourceCode} or configure the optional REALSEE_DEFAULT_RESOURCE_CODE fallback.',
+          requestId: request.id,
+        })
+      }
+      return getWork(request, reply, defaultResourceCode)
+    },
+  )
+
   app.get(
     '/api/work/:resourceCode',
     {
@@ -43,37 +91,8 @@ export function workRoutes(
     async (
       request: FastifyRequest<{ Params: WorkRouteParams }>,
       reply: FastifyReply,
-    ): Promise<WorkEnvelope | FastifyReply> => {
-      const { resourceCode } = request.params
-      const requestAbort = new AbortController()
-      const abortDisconnectedRequest = (): void => {
-        if (request.raw.aborted || !request.raw.complete) requestAbort.abort()
-      }
-      request.raw.once('close', abortDisconnectedRequest)
-
-      try {
-        return await workService.getWorkByResourceCode(resourceCode, {
-          signal: requestAbort.signal,
-        })
-      } catch (error) {
-        const statusCode = upstreamStatusCode(error)
-        request.log.error(
-          { err: error, resourceCode },
-          'Work BFF request failed',
-        )
-        return reply.code(statusCode).send({
-          error:
-            statusCode === 404
-              ? 'WORK_NOT_FOUND'
-              : statusCode === 504
-                ? 'WORK_UPSTREAM_TIMEOUT'
-                : 'WORK_UPSTREAM_FAILED',
-          requestId: request.id,
-        })
-      } finally {
-        request.raw.off('close', abortDisconnectedRequest)
-      }
-    },
+    ): Promise<WorkEnvelope | FastifyReply> =>
+      getWork(request, reply, request.params.resourceCode),
   )
 
   done()

package/templates/base/server/work-service.ts

@@ -27,8 +27,8 @@ export function createWorkService({
         .catch((error: unknown) => {
           if (!signal?.aborted) {
             console.warn(
-              `资源 ${resourceCode} 的平面图 capability 不可用，继续返回基础 Work。`,
-              error,
+              '所选空间的平面图 capability 不可用，继续返回基础 Work。',
+              error instanceof Error ? error.name : 'UnknownError',
             )
           }
           return undefined

package/templates/base/src/vr/work/WorkSource.ts

@@ -177,7 +177,9 @@ const asExplicitPanoTagList = (value: unknown): Tags['tagList'] | undefined => {
 
 export function resourceCodeFromPathname(pathname: string) {
   const segments = pathname.split('/').filter(Boolean)
-  if (segments.length !== 1) throw new Error('访问路径必须为 /{resourceCode}。')
+  if (segments.length === 0) return undefined
+  if (segments.length !== 1)
+    throw new Error('访问路径必须为 / 或 /{resourceCode}。')
   const [encodedResourceCode = ''] = segments
 
   let resourceCode: string
@@ -199,13 +201,13 @@ export class RouteWorkSource implements WorkSource {
   async load(signal?: AbortSignal): Promise<WorkPayload> {
     const resourceCode = resourceCodeFromPathname(window.location.pathname)
     // The generated Fastify BFF implements this contract; another language may replace it without changing the browser.
-    const response = await fetch(
-      `/api/work/${encodeURIComponent(resourceCode)}`,
-      {
-        signal,
-        headers: { Accept: 'application/json' },
-      },
-    )
+    const workUrl = resourceCode
+      ? `/api/work/${encodeURIComponent(resourceCode)}`
+      : '/api/work'
+    const response = await fetch(workUrl, {
+      signal,
+      headers: { Accept: 'application/json' },
+    })
     if (!response.ok) throw new Error(`Work 请求失败：HTTP ${response.status}`)
 
     const raw = (await response.json()) as unknown
@@ -221,7 +223,9 @@ export class RouteWorkSource implements WorkSource {
         work.workCode,
         work.work_code,
         work.code,
-      ) ?? resourceCode
+      ) ??
+      resourceCode ??
+      'unknown-work'
     const presetData = asRecord(envelope.presetData)
     const panoTagList = asExplicitPanoTagList(presetData.panoTagList)
     const modelFloorplan = asModelFloorplanServerData(