요청 본문 스트림은 한 번 읽으면 disturbed 가 되어 다시 읽을 수 없다. 누가 먼저 읽어 버렸는지 찾으려면 arrayBuffer·blob·formData·text·json 다섯 메서드를 Proxy 로 감싸, 불릴 때마다 console.trace 로 호출 스택을 찍고 원래 메서드를 그대로 부른다.

-- 요청 본문은 한 번만 읽힌다 (읽으면 disturbed). 누가 먼저 읽었나?
traced :: Name -> (a -> IO b) -> a -> IO b
traced name f x = trace ("Premature request." ++ name ++ " call!") >> f x   -- Proxy apply → Reflect.apply

wrap :: Request -> Request
wrap req = foldr (\m r -> set m (traced m (get m r)) r) req
                 ["arrayBuffer", "blob", "formData", "text", "json"]
#294

① 깨진 값 해독: decodeURIComponent 를 한 번 돌려도 %20 이 남으면 이중 인코딩이고, 한글은 풀리니 공백만 다시 인코딩됐다. ② 경로 좁히기: 액세스 로그의 %2520 요청이 iOS 에 몰리고 Referer 가 비어 있으면 복사-붙여넣기 경로다. ③ 우리 코드 배제: 링크 생성이 인코딩을 한 번만 하면 원인은 밖이고, iOS 버전으로 좁혀 WebKit Bug 261936 을 찾는다. ④ 고칠 수 없으니 막는다: 화이트리스트 라우트에서만 한 번 더 디코딩, 디코딩 뒤 .. // \ 차단, segment 별 재인코딩 후 301. 무조건 이중 디코딩은 ..%252f 를 ../ 로 만들어 path traversal 이 된다. ⑤ 방어 확인: curl -I 로 %2520 URL 은 301 로 정상 경로, ..%252f URL 은 차단되는지 본다.

-- URL 의 공백이 %2520 으로 깨져 들어온다 = iOS 17.0·17.1 pasteboard 가 복사할 때 다시 인코딩 (WebKit 261936)
-- 인코딩은 멱등이 아니다
encode "%20" == "%2520"          -- % 가 %25 로
decode "%2520" == "%20"          -- 한 번 풀어도 %20 이 남으면 이중 인코딩

pasteboard :: IOS -> String -> String
pasteboard v | v `elem` [17.0, 17.1] = encodeInvalid   -- %20 을 invalid 로 보고 % 를 다시 인코딩. 한글(%EA%B0%80)은 유효해서 통과
             | v < 17                = id              -- NSURL URLWithString: 이 nil
             | otherwise             = id              -- 17.2 수정

-- 추적: 깨진 값 해독 → 경로 좁히기 → 우리 코드 배제
cause :: Request -> Cause
cause r | iOS (ua r) && isNothing (referer r) = Paste   -- 클릭(JS redirect)은 pasteboard 를 안 거쳐 정상
        | otherwise                            = Ours    -- 링크 생성의 encodeURIComponent 가 한 번인지 본다

-- 고칠 수 없으니 막는다
redirect :: Path -> Response
redirect p | not (whitelisted p)                   = pass p
           | any (`isInfixOf` d) ["..", "//", "\\"] = Forbidden
           | otherwise                             = Moved301 (encodeSegments d)
  where d = decode p
-- 무조건 이중 디코딩 금지: decode (decode "..%252f") == "../" — path traversal

-- 확인: curl -I
redirect "/a%2520b"         == Moved301 "/a%20b"
redirect "/..%252f..%252f" == Forbidden

-- URL 은 디코딩된 원본으로 보관하고, 인코딩은 출력 직전 한 번
-- "방어적으로 한 번 더" 는 멱등이 아닌 연산엔 통하지 않는다
#539

drop 하면 onDragEnd 가 돌고, dnd-kit 의 drop 애니메이션은 곧바로(ASAP) 목적지를 잰다. setState 로 바꾸면 그 이벤트 처리 안에서 새 순서가 렌더되어, 잴 때 이미 새 자리라 새 자리로 애니메이션한다. setQueryData 로 바꾸면 캐시는 즉시 바뀌지만 구독자 알림은 notifyManager 의 기본 스케줄러 setTimeout(0) 을 거쳐 다음 매크로태스크에 리렌더된다. 그 사이 dnd-kit 이 옛 순서를 재서 옛 자리로 애니메이션하고, 리렌더 순간 새 자리로 점프한다 — 1~2프레임 튕김. 캐시는 바로, 화면은 한 틱 뒤다. 눈금은 비례가 아니다.

-- dnd-kit Sortable + react-query: drop 직후 옛 자리로 갔다가 새 자리로 점프 (1~2프레임)
data Update = SetState Order | SetQueryData Order
data Tick   = Sync | Microtask | Macrotask deriving (Eq, Ord)

renderAt :: Update -> Tick
renderAt (SetState _)     = Sync         -- 이벤트 처리 안에서 렌더
renderAt (SetQueryData _) = Macrotask    -- 캐시는 즉시, 알림은 notifyManager 의 setTimeout(0) 뒤

-- drop 애니메이션은 놓는 즉시 목적지를 재는데, setQueryData 의 리렌더는 setTimeout(0) 을 거쳐 한 틱 늦다
--   → 잴 때 아직 옛 순서라 옛 자리로 애니메이션하고, 리렌더 순간 새 자리로 점프한다
-- 재는 시점은 setScheduler(queueMicrotask) 로 튕김이 사라지니 Microtask 와 Macrotask 사이
bounce :: Update -> Bool
bounce u = renderAt u > Microtask        -- 기준은 상태가 바뀌는 때가 아니라 화면이 바뀌는 때

-- 고침: 화면은 local state, 캐시는 부수효과
onDragEnd :: Order -> IO ()
onDragEnd next = do
  isReordering .= True                   -- refetch 가 옛 순서로 덮지 않게: 켜져 있는 동안 서버 데이터 → local state 동기화를 건너뛴다
  setState next
  mutate next                            -- onSettled: isReordering .= False >> invalidate

-- @dnd-kit/core v6.3.1 기준. @dnd-kit/react 는 OptimisticSortingPlugin 이 기본이라 기제가 다르다

정상이면 OPTIONS 가 LB 를 지나 앱에 닿고 앱이 204 와 access-control-allow-origin 을 돌려준다. 장애면 등록된 타깃이 0 이라 LB 가 CORS 헤더 없는 503 을 직접 만들어 돌려주고, 브라우저는 그걸 CORS error 로 표시한다.

data Server = ALB | App
data Origin = Star | Origin String deriving Eq

data Preflight = Preflight
  { status       :: Int
  , server       :: Server
  , acao         :: Maybe Origin
  , allowHeaders :: [Header]
  }

data Cause = Infra Infra
           | Route                -- path 오타, ingress rule 불일치
           | Cors Cors
           | NotCors              -- CORS 아님. 본 요청의 본문·인증·에러를 본다
data Infra = NoTargets            -- 서비스 다운·배포 실패·CrashLoop
           | BadTarget            -- 크래시·OOM·포트 불일치
           | IdleTimeout          -- 느린 쿼리·외부 연동 지연
data Cors  = Unset                -- CORS 미설정
           | MissingAllowHeaders  -- access-control-allow-headers 에 요청 헤더가 빠짐
           | StarWithCredentials  -- credentials 와 * 는 병용 불가 — 오리진을 명시한다

-- 브라우저가 보는 것: ACAO 가 없으면 원인을 지운다
browser :: Preflight -> Either CORSError Preflight
browser p = maybe (Left CORSError) (const (Right p)) (acao p)

-- DevTools 에서 하는 것: 지워지기 전의 값을 본다
-- preflight 의 status 와 server 헤더 둘로 가른다 (server: awselb/2.0 이면 LB 가 직접 만든 응답)
diagnose :: Request -> Preflight -> Cause
diagnose _ (Preflight 503 ALB _ _)       = Infra NoTargets
diagnose _ (Preflight 502 ALB _ _)       = Infra BadTarget
diagnose _ (Preflight 504 ALB _ _)       = Infra IdleTimeout
diagnose _ (Preflight 404 App Nothing _) = Route
diagnose _ (Preflight _   App Nothing _) = Cors Unset
diagnose r (Preflight _ App (Just Star) _)
  | credentials r                        = Cors StarWithCredentials
diagnose r (Preflight _ App (Just _) hs)
  | not (headers r `isSubsetOf` hs)      = Cors MissingAllowHeaders
diagnose _ _                             = NotCors

-- LB 가 직접 만든 응답이다 — 앱 응답이 아니니 CORS 헤더가 붙을 수 없다 (acao = Nothing)
-- 타깃이 0 일 때만 503. 전부 unhealthy 면 그래도 보낸다
alb :: [Target] -> Request -> Response
alb [] _ = Response 503 ALB Nothing []
alb ts r = forward (if all unhealthy ts then ts else filter healthy ts) r
#599

localtunnel 은 로컬 포트에 공개 URL 을 붙인다 — 배포나 DNS 설정 없이 남에게 보여 주거나 웹훅 같은 외부 콜백을 받을 때 쓴다. 서버가 listen 을 시작하면 그 포트로 터널을 연다. 다만 너무 느려서 ngrok 이나 cloudflared 가 현실적일 수 있다.

-- 로컬 포트에 공개 URL — 배포·DNS 없이 보여 주거나 웹훅을 받을 때
tunnel :: Port -> Subdomain -> IO PublicUrl

main = listen port (tunnel port name)      -- app.listen(PORT, () => localtunnel({ port, subdomain }))
-- 너무 느렸다 → ngrok · cloudflared · localxpose (awesome-tunneling)
#68
#69