refactor(admin): use @mx-space/editor stock types; surface transient fetch errors

Drop local Stock node type defs; re-route through @mx-space/editor 0.2.0.
Stock fetch failures now distinguish 404 (Symbol not found) from transient
errors (Failed to load + retry button), so a network blip no longer claims
the symbol is unavailable.

Author: Innei

apps/admin/src/vendor/rich-editor/extensions/stock/StockKLineView.tsx

@@ -15,7 +15,7 @@ import {
   UP_STROKE,
 } from './_shared'
 import type { Bar, StockKLineInterval, StockMeta } from './types'
-import { useStockBars } from './use-stock-data'
+import { isStockNotFound, useStockBars } from './use-stock-data'
 
 type Props = {
   symbol: string
@@ -318,10 +318,12 @@ function FallbackChrome({
   symbol,
   rangeLabel,
   message,
+  onRetry,
 }: {
   symbol: string
   rangeLabel: string
   message: string
+  onRetry?: () => void
 }) {
   return (
     <PaperCardChrome>
@@ -331,8 +333,17 @@ function FallbackChrome({
           {rangeLabel}
         </span>
       </div>
-      <div className="text-fg-muted flex h-[200px] w-full items-center justify-center text-[12px] italic">
-        {message}
+      <div className="text-fg-muted flex h-[200px] w-full flex-col items-center justify-center gap-3 text-[12px] italic">
+        <span>{message}</span>
+        {onRetry ? (
+          <button
+            type="button"
+            onClick={onRetry}
+            className="text-fg-muted hover:text-fg border-border hover:border-border-strong rounded-sm border px-2 py-1 text-[11px] not-italic transition-colors"
+          >
+            Retry
+          </button>
+        ) : null}
       </div>
     </PaperCardChrome>
   )
@@ -503,7 +514,7 @@ function KLineCard({
 export function StockKLineView({ symbol, range, ema }: Props) {
   const { locale } = useI18n()
   const rangeLabel = formatRange(range.from, range.to, locale)
-  const { data, isLoading, isError } = useStockBars({
+  const { data, isLoading, isError, error, refetch } = useStockBars({
     symbol,
     from: range.from,
     to: range.to,
@@ -520,11 +531,13 @@ export function StockKLineView({ symbol, range, ema }: Props) {
     )
   }
   if (isError || !data) {
+    const notFound = isStockNotFound(error)
     return (
       <FallbackChrome
-        message="Quote unavailable"
+        message={notFound ? 'Symbol not found' : 'Failed to load chart'}
         rangeLabel={rangeLabel}
         symbol={symbol}
+        onRetry={notFound ? undefined : () => void refetch()}
       />
     )
   }

apps/admin/src/vendor/rich-editor/extensions/stock/StockNode.ts

@@ -1,5 +1,10 @@
 import type { CommandItemConfig } from '@haklex/rich-editor/commands'
 import { createRendererDecoration } from '@haklex/rich-editor/static'
+import type {
+  StockKLineRange,
+  StockNodePayload,
+  StockVariant,
+} from '@mx-space/editor'
 import type {
   EditorConfig,
   LexicalCommand,
@@ -18,26 +23,11 @@ import {
 import { LineChart } from 'lucide-react'
 import { createElement, type ReactElement } from 'react'
 
-import {
-  STOCK_NODE_KEY,
-  type StockKLineRange,
-  type StockSlotProps,
-  type StockVariant,
-} from './stock-augment'
+import { STOCK_NODE_KEY, type StockSlotProps } from './stock-augment'
 import { openStockDialog } from './stock-plugin-bridge'
 import { StockBlockConnected } from './StockBlockConnected'
 
-export type StockNodePayload =
-  | {
-      variant: 'snapshot'
-      symbol: string
-    }
-  | {
-      variant: 'kline'
-      symbol: string
-      range: StockKLineRange
-      ema?: [number, number] | false
-    }
+export type { StockNodePayload }
 
 export const INSERT_STOCK_COMMAND: LexicalCommand<StockNodePayload> =
   createCommand('INSERT_STOCK_COMMAND')

apps/admin/src/vendor/rich-editor/extensions/stock/StockSnapshotView.tsx

@@ -11,7 +11,7 @@ import {
   UP_STROKE,
 } from './_shared'
 import type { Quote, SparklinePoint, StockMeta } from './types'
-import { useStockQuote } from './use-stock-data'
+import { isStockNotFound, useStockQuote } from './use-stock-data'
 
 const SPARK_W = 220
 const SPARK_H = 56
@@ -51,7 +51,15 @@ function buildSparkPath(points: SparklinePoint[]): string {
   return segs.join(' ')
 }
 
-function Unavailable({ symbol, message }: { symbol: string; message: string }) {
+function Unavailable({
+  symbol,
+  message,
+  onRetry,
+}: {
+  symbol: string
+  message: string
+  onRetry?: () => void
+}) {
   return (
     <PaperCardChrome>
       <header className="mb-4">
@@ -63,6 +71,15 @@ function Unavailable({ symbol, message }: { symbol: string; message: string }) {
         </div>
       </header>
       <p className="text-fg-muted text-[13px]">{message}</p>
+      {onRetry ? (
+        <button
+          type="button"
+          onClick={onRetry}
+          className="text-fg-muted hover:text-fg border-border hover:border-border-strong mt-3 rounded-sm border px-2 py-1 text-[11px] transition-colors"
+        >
+          Retry
+        </button>
+      ) : null}
     </PaperCardChrome>
   )
 }
@@ -144,13 +161,20 @@ function SnapshotCard({ quote, locale }: { quote: Quote; locale: string }) {
 
 export function StockSnapshotView({ symbol }: { symbol: string }) {
   const { locale } = useI18n()
-  const { data, isLoading, isError } = useStockQuote(symbol)
+  const { data, isLoading, isError, error, refetch } = useStockQuote(symbol)
 
   if (isLoading) {
     return <Unavailable message="Loading quote…" symbol={symbol} />
   }
   if (isError || !data) {
-    return <Unavailable message="Quote unavailable" symbol={symbol} />
+    const notFound = isStockNotFound(error)
+    return (
+      <Unavailable
+        message={notFound ? 'Symbol not found' : 'Failed to load quote'}
+        symbol={symbol}
+        onRetry={notFound ? undefined : () => void refetch()}
+      />
+    )
   }
   return <SnapshotCard locale={locale} quote={data} />
 }

apps/admin/src/vendor/rich-editor/extensions/stock/stock-augment.ts

@@ -1,18 +1,11 @@
 import type {} from '@haklex/rich-editor'
+import type { StockKLineRange, StockVariant } from '@mx-space/editor'
 import type { ComponentType } from 'react'
 
-import type { StockKLineInterval } from './types'
+export { type StockKLineRange, type StockVariant } from '@mx-space/editor'
 
 export const STOCK_NODE_KEY = 'Stock' as const
 
-export type StockVariant = 'snapshot' | 'kline'
-
-export interface StockKLineRange {
-  from: string
-  interval: StockKLineInterval
-  to: string
-}
-
 export interface StockSlotProps {
   ema?: [number, number] | false
   nodeKey?: string

apps/admin/src/vendor/rich-editor/extensions/stock/types.ts

@@ -1,4 +1,4 @@
-export type StockKLineInterval = '5m' | '15m' | '1h' | '1d'
+export type { StockKLineInterval } from '@mx-space/editor'
 
 export type MarketState = 'pre' | 'regular' | 'post' | 'closed'
 

apps/admin/src/vendor/rich-editor/extensions/stock/use-stock-data.ts

@@ -8,14 +8,30 @@ function normalizeHost(url: string): string {
   return url.replace(/\/$/, '')
 }
 
+export class StockFetchError extends Error {
+  readonly status: number
+  constructor(message: string, status: number) {
+    super(message)
+    this.name = 'StockFetchError'
+    this.status = status
+  }
+}
+
+export function isStockNotFound(error: unknown): boolean {
+  return error instanceof StockFetchError && error.status === 404
+}
+
 async function fetchQuote(symbol: string): Promise<Quote> {
   const params = new URLSearchParams({ symbol })
   const res = await fetch(
     `${normalizeHost(API_URL)}/serverless/built-in/stock_quote?${params.toString()}`,
     { headers: { Accept: 'application/json' } },
   )
   if (!res.ok) {
-    throw new Error(`Failed to fetch quote (${res.status})`)
+    throw new StockFetchError(
+      `Failed to fetch quote (${res.status})`,
+      res.status,
+    )
   }
   return (await res.json()) as Quote
 }
@@ -37,7 +53,10 @@ async function fetchBars(args: {
     { headers: { Accept: 'application/json' } },
   )
   if (!res.ok) {
-    throw new Error(`Failed to fetch bars (${res.status})`)
+    throw new StockFetchError(
+      `Failed to fetch bars (${res.status})`,
+      res.status,
+    )
   }
   return (await res.json()) as BarsResult
 }