entity-server-client 0.2.4 → 0.2.5

package/src/client/request.ts

@@ -0,0 +1,102 @@
+import { derivePacketKey, encryptPacket, decryptPacket } from "./packet";
+import { buildHmacHeaders } from "./hmac";
+
+export interface RequestOptions {
+    baseUrl: string;
+    token: string;
+    apiKey: string;
+    hmacSecret: string;
+    packetMagicLen: number;
+    encryptRequests: boolean;
+}
+
+/**
+ * Entity Server에 HTTP 요청을 보냅니다.
+ *
+ * - `encryptRequests` 활성화 시 인증된 POST 바디를 자동 암호화합니다.
+ * - 응답이 `application/octet-stream`이면 자동 복호화합니다.
+ * - JSON 응답의 `ok`가 false이면 에러를 던집니다.
+ */
+export async function entityRequest<T>(
+    opts: RequestOptions,
+    method: string,
+    path: string,
+    body?: unknown,
+    withAuth = true,
+    extraHeaders: Record<string, string> = {},
+): Promise<T> {
+    const {
+        baseUrl,
+        token,
+        apiKey,
+        hmacSecret,
+        packetMagicLen,
+        encryptRequests,
+    } = opts;
+    const isHmacMode = withAuth && !!(apiKey && hmacSecret);
+
+    const headers: Record<string, string> = {
+        "Content-Type": "application/json",
+        ...extraHeaders,
+    };
+    if (!isHmacMode && withAuth && token) {
+        headers.Authorization = `Bearer ${token}`;
+    }
+
+    let fetchBody: string | Uint8Array | null = null;
+    if (body != null) {
+        const shouldEncrypt =
+            encryptRequests &&
+            withAuth &&
+            (token || isHmacMode) &&
+            method !== "GET" &&
+            method !== "HEAD";
+
+        if (shouldEncrypt) {
+            const key = derivePacketKey(hmacSecret, token);
+            fetchBody = encryptPacket(
+                new TextEncoder().encode(JSON.stringify(body)),
+                key,
+                packetMagicLen,
+            );
+            headers["Content-Type"] = "application/octet-stream";
+        } else {
+            fetchBody = JSON.stringify(body);
+        }
+    }
+
+    if (isHmacMode) {
+        const bodyBytes =
+            fetchBody instanceof Uint8Array
+                ? fetchBody
+                : typeof fetchBody === "string"
+                  ? new TextEncoder().encode(fetchBody)
+                  : new Uint8Array(0);
+        Object.assign(
+            headers,
+            buildHmacHeaders(method, path, bodyBytes, apiKey, hmacSecret),
+        );
+    }
+
+    const res = await fetch(baseUrl + path, {
+        method,
+        headers,
+        ...(fetchBody != null ? { body: fetchBody as BodyInit } : {}),
+    });
+
+    const contentType = res.headers.get("Content-Type") ?? "";
+    if (contentType.includes("application/octet-stream")) {
+        const key = derivePacketKey(hmacSecret, token);
+        return decryptPacket<T>(await res.arrayBuffer(), key, packetMagicLen);
+    }
+
+    const data = await res.json();
+    if (!data.ok) {
+        const err = new Error(
+            data.message ?? `EntityServer error (HTTP ${res.status})`,
+        );
+        (err as { status?: number }).status = res.status;
+        throw err;
+    }
+    return data as T;
+}

package/src/client/utils.ts

@@ -0,0 +1,18 @@
+/** Vite 환경변수(`import.meta.env`)에서 값을 읽습니다. */
+export function readEnv(name: string): string | undefined {
+    const meta = import.meta as unknown as {
+        env?: Record<string, string | undefined>;
+    };
+    return meta?.env?.[name];
+}
+
+/** 쿼리 파라미터 객체를 URL 쿼리 문자열로 변환합니다. `orderBy` 키는 `order_by`로 변환됩니다. */
+export function buildQuery(params: Record<string, unknown>): string {
+    return Object.entries(params)
+        .filter(([, value]) => value != null)
+        .map(
+            ([key, value]) =>
+                `${encodeURIComponent(key === "orderBy" ? "order_by" : key)}=${encodeURIComponent(String(value))}`,
+        )
+        .join("&");
+}