4장: npm 호환과 패키지 관리

// npm 패키지를 직접 import
import express from "npm:express@4";
import { z } from "npm:zod@3";
import chalk from "npm:chalk@5";
 
// 바로 사용 가능
const app = express();
 
const UserSchema = z.object({
  name: z.string(),
  email: z.string().email(),
});
 
console.log(chalk.green("서버 시작"));
app.listen(3000);

// 정확한 버전
import lodash from "npm:lodash@4.17.21";
 
// 메이저 버전 범위
import express from "npm:express@4";
 
// 마이너 버전 범위
import zod from "npm:zod@3.22";
 
// 최신 버전 (프로덕션에서는 권장하지 않음)
import dayjs from "npm:dayjs";

{
  "nodeModulesDir": "auto"
}

"none"  - node_modules를 생성하지 않음 (기본값)
"auto"  - 필요할 때 자동으로 node_modules 생성
"manual" - npm install로 직접 관리하는 node_modules 사용

1. TypeScript를 네이티브로 지원하지 않음
   - .d.ts 파일을 별도로 관리해야 함
   - @types/* 패키지에 의존
 
2. ESM/CJS 이중 발행의 복잡성
   - 두 모듈 시스템을 모두 지원하려면 빌드 설정이 복잡
 
3. 패키지 품질 검증 부재
   - 누구나 발행 가능, 품질 기준 없음
 
4. 보안 검증 한계
   - 패키지 소유권 탈취 사례 빈발

// jsr: 접두사로 JSR 패키지 import
import { assertEquals } from "jsr:@std/assert@1";
import { join } from "jsr:@std/path@1";
import { parse } from "jsr:@std/csv@1";
 
// Deno 표준 라이브러리는 모두 JSR에서 관리됩니다

# JSR 패키지 추가
deno add jsr:@std/assert
deno add jsr:@std/path
 
# npm 패키지도 추가 가능
deno add npm:express@4
deno add npm:zod
 
# 추가된 패키지는 deno.json의 imports에 자동 등록됩니다

{
  "imports": {
    "@std/assert": "jsr:@std/assert@^1.0.0",
    "@std/path": "jsr:@std/path@^1.0.0",
    "express": "npm:express@^4.18.0",
    "zod": "npm:zod@^3.22.0"
  }
}

{
  "name": "@myorg/my-library",
  "version": "1.0.0",
  "exports": "./mod.ts"
}

# 패키지 발행
deno publish
 
# 발행 전 검증 (드라이런)
deno publish --dry-run

{
  "imports": {
    "@/": "./src/",
    "@db/": "./src/database/",
    "@utils/": "./src/utils/",
    "@std/assert": "jsr:@std/assert@^1.0.0",
    "express": "npm:express@^4.18.0",
    "zod": "npm:zod@^3.22.0",
    "hono": "jsr:@hono/hono@^4.0.0"
  }
}

// Import Map 덕분에 깔끔한 경로 사용 가능
import { UserService } from "@/services/user.ts";
import { connectDB } from "@db/connection.ts";
import { formatDate } from "@utils/date.ts";
import { assertEquals } from "@std/assert";
import { Hono } from "hono";

{
  "imports": {
    "zod": "npm:zod@^3.22.4"
  }
}

// src/routes/user.ts
import { z } from "zod"; // 3.22.4 사용
 
// src/routes/product.ts
import { z } from "zod"; // 동일한 3.22.4 사용
 
// 버전 변경은 deno.json 한 곳에서만 수행

# Lock 파일 자동 생성/업데이트 (기본 동작)
deno run main.ts
 
# Lock 파일 무결성 검증 (CI에서 사용)
deno run --frozen main.ts
 
# Lock 파일 없이 실행 (권장하지 않음)
deno run --no-lock main.ts

{
  "nodeModulesDir": "auto",
  "tasks": {
    "dev": "deno run --allow-all src/index.ts",
    "test": "deno test --allow-all"
  }
}

{
  "dependencies": {
    "express": "^4.18.0",
    "zod": "^3.22.0",
    "pg": "^8.11.0"
  }
}

{
  "imports": {
    "express": "npm:express@^4.18.0",
    "zod": "npm:zod@^3.22.0",
    "pg": "npm:pg@^8.11.0"
  }
}

// Before: Node.js 방식
import { readFileSync } from "node:fs";
const content = readFileSync("./data.json", "utf-8");
 
// After: Deno 방식
const content = await Deno.readTextFile("./data.json");
 
// Before: Node.js HTTP 서버
import http from "node:http";
const server = http.createServer((req, res) => {
  res.end("Hello");
});
server.listen(3000);
 
// After: Deno HTTP 서버
Deno.serve({ port: 3000 }, (_req) => {
  return new Response("Hello");
});

1. 네이티브 바이너리 모듈
   - node-gyp 기반 C++ 모듈은 호환되지 않을 수 있음
   - bcrypt, sharp 등 네이티브 모듈 대안 확인 필요
 
2. require() 사용 코드
   - Deno는 기본적으로 ESM만 지원
   - npm 패키지 내부의 require()는 호환 레이어가 처리
   - 프로젝트 코드의 require()는 import로 전환 필요
 
3. 글로벌 변수 차이
   - __dirname, __filename은 import.meta로 대체
   - process 객체 접근 방식 변경
 
4. 테스트 프레임워크
   - Jest/Mocha에서 Deno.test 또는 호환 러너로 전환

// Node.js
const dir = __dirname;
const file = __filename;
 
// Deno
const dir = new URL(".", import.meta.url).pathname;
const file = new URL(import.meta.url).pathname;
 
// 또는 @std/path 활용
import { dirname, fromFileUrl } from "jsr:@std/path";
const dir = dirname(fromFileUrl(import.meta.url));