[2025.07.18 주간 개발 트렌드] Amazon Bedrock AgentCore 정리 (Agent 실행, 기억, 권한 관리)

![주간 개발 트렌드](https://librarian-blog-images.s3.ap-northeast-2.amazonaws.com/b28d786c-9ec3-46ec-8055-adcd53a303c5_thumbnail_2.png)

# TypeScript 5.9 Beta에서 뭐가 바뀌었나

typescript로 개발하다보면 타입도 타입인데 설정에서 막힐때가 꽤 있다. tsconfig.json을 열어보면 옵션이 정말 많다..

이번주 7월 8일에 [TypeScript 5.9 Beta](https://devblogs.microsoft.com/typescript/announcing-typescript-5-9-beta/)가 공개됐다. 이번주 개발트렌드로 달라진 내용을 정리해보려고 한다.

핵심은 import defer, 새 tsconfig 기본 설정, Node.js 20용 모듈 설정이다. 아직 Beta 단계이니 우선 어떤 기능이 들어왔는지 코드로 살펴보자.

# 1. import defer는 무슨 기능인가

모듈의 최상위 코드는 평가 과정에서 실행된다. 함수 안과 바깥의 코드는 구분해서 봐야한다.

```typescript
// report.ts
console.log("보고서 모듈 초기화");
const formatter = new Intl.NumberFormat("ko-KR");

export function formatCount(count: number) {
  return formatter.format(count);
}
```

위 코드의 console.log와 formatter 생성은 함수 호출을 기다리지 않는다. import defer를 사용하면 다음처럼 작성할 수 있다.

```typescript
// app.ts
import defer * as report from "./report.js";

export function showReport(count: number) {
  return report.formatCount(count);
}
```

다른 곳에서 report를 먼저 실행하지 않았다고 가정하면, report.formatCount 속성에 접근할때 미뤄뒀던 동기 평가를 진행한다.

가끔 쓰는 기능의 초기화를 미룰 수 있다는 의미다. 비용이 사라지는것은 아니니 시작 시간과 첫 기능 실행 시간은 같이 봐야겠다.

## import()랑은 뭐가 다른가

```typescript
const report = await import("./report.js");
```

import()는 호출할때 모듈을 가져오는 과정을 시작하고 Promise를 반환한다. import defer는 모듈을 미리 로드하고 연결해둔 뒤 동기 평가를 늦춘다.

**다운로드까지 나중에 하는 lazy loading으로 이해하면 안된다.** 무엇을 미루려는지에 따라 선택해야한다. [제안의 동작 설명](https://github.com/tc39/proposal-defer-import-eval)

문법에도 조건이 있다. namespace import 형태만 가능하고, 5.9 Beta에서는 module이 preserve 또는 esnext여야한다. TypeScript가 예전 문법으로 변환해주지도 않으므로 실행 환경이나 번들러의 지원도 필요하다.

또한 최상위 await가 있는 비동기 의존성은 미리 평가되는 부분이 있다. 다른 파일에서 같은 모듈을 일반 import하면 이미 평가될 수도 있다. defer 한줄로 전체 실행 순서가 전부 미뤄진다고 생각하면 안된다.

# 2. tsc --init 설정도 달라졌다

```bash
npx tsc --init
```

5.9에서는 새 tsconfig.json의 긴 주석 목록을 줄이고 기본 구성을 정리했다. noUncheckedIndexedAccess와 exactOptionalPropertyTypes 같은 엄격한 옵션도 새 기본 설정에 포함됐다.

여기서 **기존 tsconfig를 자동으로 바꿔주는것은 아니다.** 새로 생성하는 설정이 달라진것이고, 아래 옵션들이 전부 5.9에서 처음 생긴것도 아니다.

## 배열에서 꺼낸 값이 없을 수 있다

```typescript
const titles: string[] = ["첫번째 글"];
const title = titles[3];

title.toUpperCase();
```

배열 타입은 string[]이지만 실제로 3번 위치에 값이 있을까? 위 코드에서는 없다.

noUncheckedIndexedAccess를 켜면 이런 접근의 결과에 undefined 가능성이 포함된다. strictNullChecks도 켜져있다면 바로 사용하는 코드를 검사할 수 있다. [옵션의 동작](https://www.typescriptlang.org/tsconfig/noUncheckedIndexedAccess.html)

```typescript
const title = titles[3];

if (title === undefined) {
  throw new Error("해당 위치에 글이 없습니다");
}

console.log(title.toUpperCase());
```

값이 없을때 처리하거나 ??로 기본값을 정해주면 된다. 느낌표로 빨간줄만 지우면 값이 없는 상황은 그대로 남는다.

## 속성이 없는것과 undefined는 다르다

```typescript
type ProfileUpdate = { nickname?: string };

const first: ProfileUpdate = {};
const second: ProfileUpdate = { nickname: undefined };
```

첫번째에는 nickname 속성이 없고 두번째에는 속성이 있다. "nickname" in 객체로 확인하면 결과도 달라진다.

exactOptionalPropertyTypes를 켜면 속성이 없다면 괜찮지만, 있다면 선언한 string이어야한다. 따라서 second는 타입 에러가 난다. undefined를 직접 넣을 의도라면 nickname?: string | undefined처럼 적어줘야한다. [옵션의 동작](https://www.typescriptlang.org/tsconfig/exactOptionalPropertyTypes.html)

API나 JSON 동작을 바꾸는게 아니라 객체를 만들때 의도를 검사하는 옵션이다.

## process를 못찾는다면 types도 확인하자

새 기본 설정의 types: []는 보이는 모든 @types 패키지를 전역 타입으로 자동 포함하지 않게 한다. Node.js 전역 타입이 필요하다면 @types/node를 설치하고 types에 node를 지정할 수 있다.

```json
{
  "compilerOptions": {
    "types": ["node"]
  }
}
```

import한 라이브러리 타입과 전역 타입은 구분해야한다. @types/node와 실제 런타임 설치도 별개다. [types 설정 설명](https://www.typescriptlang.org/tsconfig/types.html)

# 3. module: node20은 언제 쓰는건가

nodenext는 TypeScript가 따라가는 최신 Node.js의 모듈 동작에 맞춰 바뀔 수 있다. node20은 Node.js 20 동작을 기준으로 잡는 선택지다.

target을 따로 지정하지 않으면 node20은 es2023을 적용한다. nodenext가 기본적으로 esnext를 따르는것과 차이가 있다.

```json
{
  "compilerOptions": {
    "module": "node20",
    "strict": true
  }
}
```

위 코드는 설정 일부다. 이걸 적는다고 Node.js 버전이 바뀌거나 import와 require를 마음대로 섞어도 되는것은 아니다. 파일 확장자와 package.json의 type 값도 같이 봐야한다.

Vite나 Next.js처럼 번들러가 처리하는 프로젝트에 그대로 복사하는것도 조심해야한다. 최종 코드를 어디서 실행하는지 정한 뒤 module 설정을 고르는게 맞을것 같다.

앞의 import defer 예제와 이 node20 설정도 별개의 설명이다. 두개를 한꺼번에 넣으면 되는 예제로 보면 안된다.

# 4. 기존 프로젝트에서 확인할것

hover에서 타입을 더 펼쳐보는 Preview 기능과 DOM API 설명도 개선됐다. 에디터의 TypeScript 버전도 확인해보자.

업데이트를 실험한다면 설정을 한꺼번에 바꾸기보다는 다음처럼 나누면 좋겠다.

1. 별도 브랜치에서 컴파일러 버전만 바꾸고 검사한다.
2. 새 에러와 기존 설정의 관계를 확인한다.
3. 새 기본 옵션은 필요한것부터 하나씩 적용한다.
4. 실제 빌드 결과와 테스트도 확인한다.

```bash
npx tsc --noEmit
```

타입 검사만 해볼때는 위 명령을 사용할 수 있다. 프레임워크의 전용 검사나 빌드가 있다면 그것도 실행해야한다. tsc가 통과했다고 실제 환경이 새 문법을 전부 지원하는것은 아니기 때문이다.

# 마무리

이번 업데이트는 타입 검사와 실제 실행 환경을 같이 생각하게 만드는 부분이 많다. import defer는 평가 시점, node20은 모듈 규칙, 새 기본 설정은 놓치기 쉬운 값의 상태를 다룬다.

개인적으로는 배열에서 값이 없을때를 잡아주는 부분이 눈에 들어왔다. 처음에는 귀찮은 에러처럼 보여도 왜 문제가 되는지 알고나면 코드의 빈틈을 찾는데 도움이 되는것 같다.

typescript는 타입 에러 하나 해결하면 설정에서 또 다른걸 만나게 되는것 같다.. 그래도 이유를 하나씩 알고 넘어가는게 나중에 덜 고생하는 방법인것 같다.


[2025.07.11 주간 개발 트렌드] TypeScript 5.9 Beta 정리 (import defer, node20, tsconfig)

독자의 메모