@zipbul/shared 0.0.1

package/README.ko.md

@@ -0,0 +1,64 @@
+# @zipbul/shared
+
+[English](./README.md) | **한국어**
+
+`@zipbul` 툴킷의 공유 라이브러리입니다.
+여러 `@zipbul` 패키지에서 공통으로 사용하는 열거형(enum), 상수, 타입, 유틸리티 등을 제공합니다.
+
+<br>
+
+## 📦 설치
+
+```bash
+bun add @zipbul/shared
+```
+
+<br>
+
+## 📚 구성 요소
+
+### HTTP 열거형
+
+HTTP 메서드, 헤더, 상태 코드에 대한 타입 안전한 `const enum` 선언으로 매직 스트링을 제거합니다.
+
+```typescript
+import { HttpMethod, HttpHeader, HttpStatus } from '@zipbul/shared';
+
+if (request.method === HttpMethod.Get) {
+  headers.set(HttpHeader.AccessControlAllowOrigin, '*');
+  return new Response('OK', { status: HttpStatus.Ok });
+}
+```
+
+| Export       | 설명                                  |
+|:-------------|:--------------------------------------|
+| `HttpMethod` | 표준 HTTP 메서드 (`Get`, `Post`, `Put`, `Patch`, `Delete`, …) |
+| `HttpHeader` | CORS 관련 HTTP 헤더 (Fetch Standard, 소문자 값) |
+| `HttpStatus` | 공통 HTTP 상태 코드 (`Ok`, `NoContent`, …) |
+
+> 열거형은 `const enum`입니다 — `isolatedModules: false` 환경에서는 컴파일 타임에 값이 **인라인**되어 런타임 비용이 없습니다. 툴체인별 동작은 [`const enum`에 대하여](#-const-enum에-대하여)를 참고하세요.
+
+<br>
+
+## 🔬 `const enum`에 대하여
+
+모든 열거형은 `const enum`으로 선언되어 있으며, 툴체인에 따라 동작이 다릅니다:
+
+| 환경 | 동작 |
+|:-----|:-----|
+| TypeScript (`isolatedModules: false`) | 컴파일 타임에 값이 **인라인** — 런타임 객체 없음 |
+| 번들러 (Bun, esbuild, Vite) | **일반 enum** 취급 — 런타임 객체가 생성됨 |
+| `isolatedModules: true` / `verbatimModuleSyntax: true` | import가 보존되며, 번들러가 빌드 타임에 해소 |
+
+이것이 의미하는 바:
+- **Bun 소비자**는 열거형을 정상적으로 사용 가능 — `bun build`가 해소를 처리
+- **TypeScript 라이브러리 소비자**는 컴파일 타임 인라인의 이점을 누림 (런타임 비용 제로)
+- `.d.ts` 파일은 `const enum` 선언을 보존하여 다운스트림 소비자에게 전달
+
+> **참고:** `verbatimModuleSyntax: true`와 `emitDeclarationOnly`로 빌드할 때 TS2748 오류를 방지하려면 `tsconfig.build.json`에서 `verbatimModuleSyntax: false`를 설정해야 합니다. 빌드 설정에 이미 반영되어 있습니다.
+
+<br>
+
+## 📄 라이선스
+
+MIT

package/README.md

@@ -0,0 +1,64 @@
+# @zipbul/shared
+
+**English** | [한국어](./README.ko.md)
+
+Shared library for the `@zipbul` toolkit.
+Provides common definitions — enums, constants, types, and utilities — used across multiple `@zipbul` packages.
+
+<br>
+
+## 📦 Installation
+
+```bash
+bun add @zipbul/shared
+```
+
+<br>
+
+## 📚 What's Inside
+
+### HTTP Enums
+
+Type-safe `const enum` declarations that eliminate magic strings for HTTP methods, headers, and status codes.
+
+```typescript
+import { HttpMethod, HttpHeader, HttpStatus } from '@zipbul/shared';
+
+if (request.method === HttpMethod.Get) {
+  headers.set(HttpHeader.AccessControlAllowOrigin, '*');
+  return new Response('OK', { status: HttpStatus.Ok });
+}
+```
+
+| Export       | Description                          |
+|:-------------|:-------------------------------------|
+| `HttpMethod` | Standard HTTP methods (`Get`, `Post`, `Put`, `Patch`, `Delete`, …) |
+| `HttpHeader` | CORS-related HTTP headers (Fetch Standard, lowercase values) |
+| `HttpStatus` | Common HTTP status codes (`Ok`, `NoContent`, …) |
+
+> Enums are `const enum` — with `isolatedModules: false`, values are **inlined at compile time** with zero runtime footprint. See [About `const enum`](#-about-const-enum) for toolchain-specific behavior.
+
+<br>
+
+## 🔬 About `const enum`
+
+All enums are declared as `const enum`, which has different behavior depending on your toolchain:
+
+| Environment | Behavior |
+|:------------|:---------|
+| TypeScript (`isolatedModules: false`) | Values are **inlined** at compile time — no runtime object |
+| Bundlers (Bun, esbuild, Vite) | Treated as **regular enums** — runtime object is emitted |
+| `isolatedModules: true` / `verbatimModuleSyntax: true` | Import is preserved; the bundler resolves it at build time |
+
+This means:
+- **Bun consumers** can use the enums normally — `bun build` handles the resolution
+- **TypeScript library consumers** get the benefit of compile-time inlining (zero runtime cost)
+- The `.d.ts` files preserve the `const enum` declarations for downstream consumers
+
+> **Note:** When building with `verbatimModuleSyntax: true` and `emitDeclarationOnly`, you may need to set `verbatimModuleSyntax: false` in `tsconfig.build.json` to avoid TS2748. This is already handled in the build configuration.
+
+<br>
+
+## 📄 License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './src/enums';

package/dist/index.js

@@ -0,0 +1,40 @@
+// @bun
+// src/enums/http-method.ts
+var HttpMethod;
+((HttpMethod2) => {
+  HttpMethod2["Get"] = "GET";
+  HttpMethod2["Head"] = "HEAD";
+  HttpMethod2["Post"] = "POST";
+  HttpMethod2["Put"] = "PUT";
+  HttpMethod2["Patch"] = "PATCH";
+  HttpMethod2["Delete"] = "DELETE";
+  HttpMethod2["Options"] = "OPTIONS";
+})(HttpMethod ||= {});
+// src/enums/http-header.ts
+var HttpHeader;
+((HttpHeader2) => {
+  HttpHeader2["Origin"] = "origin";
+  HttpHeader2["Vary"] = "vary";
+  HttpHeader2["AccessControlAllowOrigin"] = "access-control-allow-origin";
+  HttpHeader2["AccessControlAllowMethods"] = "access-control-allow-methods";
+  HttpHeader2["AccessControlAllowHeaders"] = "access-control-allow-headers";
+  HttpHeader2["AccessControlAllowCredentials"] = "access-control-allow-credentials";
+  HttpHeader2["AccessControlExposeHeaders"] = "access-control-expose-headers";
+  HttpHeader2["AccessControlMaxAge"] = "access-control-max-age";
+  HttpHeader2["AccessControlRequestMethod"] = "access-control-request-method";
+  HttpHeader2["AccessControlRequestHeaders"] = "access-control-request-headers";
+})(HttpHeader ||= {});
+// src/enums/http-status.ts
+var HttpStatus;
+((HttpStatus2) => {
+  HttpStatus2[HttpStatus2["Ok"] = 200] = "Ok";
+  HttpStatus2[HttpStatus2["NoContent"] = 204] = "NoContent";
+})(HttpStatus ||= {});
+export {
+  HttpStatus,
+  HttpMethod,
+  HttpHeader
+};
+
+//# debugId=5DF757687905BEE364756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/enums/http-method.ts", "../src/enums/http-header.ts", "../src/enums/http-status.ts"],
+  "sourcesContent": [
+    "export const enum HttpMethod {\n  Get = 'GET',\n  Head = 'HEAD',\n  Post = 'POST',\n  Put = 'PUT',\n  Patch = 'PATCH',\n  Delete = 'DELETE',\n  Options = 'OPTIONS',\n}\n",
+    "export const enum HttpHeader {\n  Origin = 'origin',\n  Vary = 'vary',\n  AccessControlAllowOrigin = 'access-control-allow-origin',\n  AccessControlAllowMethods = 'access-control-allow-methods',\n  AccessControlAllowHeaders = 'access-control-allow-headers',\n  AccessControlAllowCredentials = 'access-control-allow-credentials',\n  AccessControlExposeHeaders = 'access-control-expose-headers',\n  AccessControlMaxAge = 'access-control-max-age',\n  AccessControlRequestMethod = 'access-control-request-method',\n  AccessControlRequestHeaders = 'access-control-request-headers',\n}\n",
+    "export const enum HttpStatus {\n  Ok = 200,\n  NoContent = 204,\n}\n"
+  ],
+  "mappings": ";;AAAO,IAAW;AAAA,CAAX,CAAW,gBAAX;AAAA,EACL,qBAAM;AAAA,EACN,sBAAO;AAAA,EACP,sBAAO;AAAA,EACP,qBAAM;AAAA,EACN,uBAAQ;AAAA,EACR,wBAAS;AAAA,EACT,yBAAU;AAAA,GAPM;;ACAX,IAAW;AAAA,CAAX,CAAW,gBAAX;AAAA,EACL,wBAAS;AAAA,EACT,sBAAO;AAAA,EACP,0CAA2B;AAAA,EAC3B,2CAA4B;AAAA,EAC5B,2CAA4B;AAAA,EAC5B,+CAAgC;AAAA,EAChC,4CAA6B;AAAA,EAC7B,qCAAsB;AAAA,EACtB,4CAA6B;AAAA,EAC7B,6CAA8B;AAAA,GAVd;;ACAX,IAAW;AAAA,CAAX,CAAW,gBAAX;AAAA,EACL,gCAAK,OAAL;AAAA,EACA,uCAAY,OAAZ;AAAA,GAFgB;",
+  "debugId": "5DF757687905BEE364756E2164756E21",
+  "names": []
+}

package/dist/src/enums/http-header.d.ts

@@ -0,0 +1,12 @@
+export declare const enum HttpHeader {
+    Origin = "origin",
+    Vary = "vary",
+    AccessControlAllowOrigin = "access-control-allow-origin",
+    AccessControlAllowMethods = "access-control-allow-methods",
+    AccessControlAllowHeaders = "access-control-allow-headers",
+    AccessControlAllowCredentials = "access-control-allow-credentials",
+    AccessControlExposeHeaders = "access-control-expose-headers",
+    AccessControlMaxAge = "access-control-max-age",
+    AccessControlRequestMethod = "access-control-request-method",
+    AccessControlRequestHeaders = "access-control-request-headers"
+}

package/dist/src/enums/http-method.d.ts

@@ -0,0 +1,9 @@
+export declare const enum HttpMethod {
+    Get = "GET",
+    Head = "HEAD",
+    Post = "POST",
+    Put = "PUT",
+    Patch = "PATCH",
+    Delete = "DELETE",
+    Options = "OPTIONS"
+}

package/dist/src/enums/http-status.d.ts

@@ -0,0 +1,4 @@
+export declare const enum HttpStatus {
+    Ok = 200,
+    NoContent = 204
+}

package/dist/src/enums/index.d.ts

@@ -0,0 +1,3 @@
+export * from './http-method';
+export * from './http-header';
+export * from './http-status';

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@zipbul/shared",
+  "version": "0.0.1",
+  "description": "Shared library for the @zipbul toolkit",
+  "license": "MIT",
+  "author": "Junhyung Park (https://github.com/parkrevil)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zipbul/toolkit",
+    "directory": "packages/shared"
+  },
+  "bugs": "https://github.com/zipbul/toolkit/issues",
+  "homepage": "https://github.com/zipbul/toolkit/tree/main/packages/shared#readme",
+  "keywords": ["enum", "constants", "shared", "typescript", "zipbul"],
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "type": "module",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "bun build index.ts --outdir dist --target bun --format esm --sourcemap=linked && tsc -p tsconfig.build.json"
+  }
+}