Server API 호출하기

const API_BASE = 'https://api.edicus.io'
const RESOURCE_BASE = 'https://resource-dot-edicusbase.appspot.com'

export class EdicusError extends Error {
  constructor(
    readonly endpoint: string,
    readonly httpStatus: number,
    // api.edicus.io의 error.code. 리소스 호스트는 body 모양이 달라 없을 수 있습니다
    readonly code: string | undefined,
    // 문의할 때 함께 알려 주는 값입니다
    readonly requestId: string | undefined,
    readonly body: unknown,
  ) {
    super(`${endpoint} 실패 (${httpStatus}${code ? ` ${code}` : ''})`)
  }
}

type CallOptions = {
  method?: 'GET' | 'POST' | 'PUT' | 'DELETE'
  uid?: string
  targetUid?: string
  body?: unknown
  host?: 'api' | 'resource'
}

export async function callEdicus<T>(path: string, opts: CallOptions = {}): Promise<T> {
  const { method = 'GET', uid, targetUid, body, host = 'api' } = opts

  const headers: Record<string, string> = {
    'edicus-api-key': process.env.EDICUS_API_KEY!,
  }
  if (uid) headers['edicus-uid'] = uid
  if (targetUid) headers['edicus-target-uid'] = targetUid
  if (body !== undefined) headers['content-type'] = 'application/json'

  const res = await fetch(`${host === 'api' ? API_BASE : RESOURCE_BASE}${path}`, {
    method,
    headers,
    body: body === undefined ? undefined : JSON.stringify(body),
    signal: AbortSignal.timeout(30_000),
  })

  const json = await res.json().catch(() => undefined)

  // 실패는 상태 코드로 옵니다. api.edicus.io는 body가 { error: { code, message, details?, request_id } }입니다
  if (!res.ok) {
    const error = (json as { error?: { code?: string; request_id?: string } } | undefined)?.error
    throw new EdicusError(
      `${method} ${path}`,
      res.status,
      error?.code,
      error?.request_id ?? res.headers.get('x-request-id') ?? undefined,
      json,
    )
  }

  return json as T
}

import type { components } from './edicus-server-api'

type Schemas = components['schemas']

export type Project = Schemas['Project']
export type ProjectListResult = Schemas['ProjectListResult']
export type PreviewUrlsManyResult = Schemas['PreviewUrlsManyResult']
export type CloneResult = Schemas['CloneResult']
export type CloneAsyncResult = Schemas['CloneAsyncResult']
export type CanOrderResult = Schemas['CanOrderResult']
export type TentativeOrderResult = Schemas['TentativeOrderResult']
export type DefinitiveOrderResult = Schemas['DefinitiveOrderResult']
export type CancelOrderResult = Schemas['CancelOrderResult']