---
title: 패키지
description: 표준 라이브러리, 커넥터 구조, 데이터 저장소에서 콘텐츠가 고정된 함수와 JSON 구조를 가져옵니다.
species: reference
---
# 패키지

typesql 패키지는 함수, 모델 시그니처, JSON 구조를 담은 버전이 지정된 네임스페이스입니다. 이름 확인은 콘텐츠에 고정됩니다. `typesql.lock`의 바이트가 같으면 항상 같은 패키지 아티팩트를 선택합니다.

```typesql
import type shapes from 'connector/stripe';
import finance from 'skycrane/finance';
```

## 패키지 이름

참조는 정확히 `stdlib`이거나 소문자 `namespace/name`이어야 합니다. 각 부분은 `a-z`로 시작하며 이후에는 `a-z`, `0-9`, `_`, `-`를 사용할 수 있습니다.

조직 패키지는 `packages/<namespace>/<name>/typesql.pkg`에 있습니다. `connector/*`는 커넥터 구조 패키지용으로 예약되어 있습니다. 절대 경로, `.`, `..`, 반복 구분 기호, 대문자 별칭, 세 번째 경로 부분은 허용하지 않습니다.

## 가져오기

`import type`은 구조와 시그니처를 가져온 뒤 완전히 소거됩니다. 단독 `import`는 함수 본문도 가져오며 전체 typesql 계층에 속합니다.

패키지는 직접 파일 시스템을 읽지 않습니다. 호출자가 정규 아티팩트 경로가 저장소의 `packages/` 디렉터리 안에 있는지 검증하고 바이트를 제공합니다.

## 잠금 파일

`typesql.lock`은 정확한 아티팩트 해시마다 정렬된 줄 1개를 사용합니다.

```text
typesql-lock-v1
package skycrane/finance sha256:813c25d0f81d8963fd60345cf6be0a8d3e40f52612f491d6d97e06c77b16f9d0
```

고정 항목이 없으면 `TS0601`, 아티팩트가 없으면 `TS0602`, 해시가 일치하지 않으면 `TS0603`을 사용합니다. 형식, 내보내기, 순환, 가림, 리소스 제한, 사용하지 않는 가져오기 오류는 `TS0604`부터 `TS0609`까지 사용합니다.