@nodus-lib/nodus 0.0.4 → 0.0.6

package/README.md

@@ -1,11 +1,11 @@
 # next-session-inspector
 
-Next.js 미들웨어에서 `nodus_session` 쿠키를 발급하고 유지하며, 방문 이벤트를 Nodus로 전송하는 경량 패키지입니다.
+Next.js 미들웨어에서 세션 쿠키(`nodus_session`)를 발급하고 유지하는 경량 패키지입니다.
 
 ## 요구 사항
 
 - Node.js `>=18.18.0`
-- Next.js `>=14`
+- Next.js `>=14` (peer dependency)
 
 ## 설치
 
@@ -15,23 +15,52 @@ npm install @nodus-lib/nodus
 
 ## 사용법
 
-프로젝트의 `middleware.ts` 파일을 만들거나 수정합니다.
+앱 루트의 `middleware.ts`에서 그대로 내보냅니다.
 
 ```ts
 export { middleware, config } from "@nodus-lib/nodus";
 ```
 
-Nodus 사이트 키를 환경 변수로 설정합니다.
+또는 한 파일에서 감싸서 추가 로직을 실행할 수 있습니다.
+
+```ts
+import type { NextRequest } from "next/server";
+import { middleware as baseMiddleware } from "@nodus-lib/nodus";
+
+export function middleware(request: NextRequest) {
+  const response = baseMiddleware(request);
+
+  // 추가 로직
+
+  return response;
+}
+
+export { config } from "@nodus-lib/nodus";
+```
+
+## 환경 변수
+
+방문 이벤트를 Nodus로 전송하려면 사이트 키를 설정합니다.
 
 ```env
 NODUS_SITE_KEY=site_xxx
 ```
 
-## 동작 방식
+사이트 키가 없으면 세션 쿠키만 발급하고 방문 이벤트는 전송하지 않습니다.
+
+## 동작
 
-미들웨어는 페이지 요청에서 실행되며, 기존 `nodus_session` 쿠키가 있으면 재사용하고 없으면 새로 발급합니다.
+- 쿠키 이름: `nodus_session`
+- 기존 쿠키가 있으면 재사용합니다.
+- 쿠키가 없으면 `crypto.randomUUID()`로 새 세션 ID를 생성합니다.
+- 쿠키 옵션: `httpOnly`, `sameSite: "lax"`, `secure: true`, `path: "/"`
+- 쿠키 최대 수명: 1년
 
-기본 matcher는 다음 요청을 제외합니다.
+## config.matcher
+
+기본 matcher는 정적 자산, API, favicon 등을 제외한 페이지 중심 경로에 적용됩니다.
+
+제외되는 기본 경로:
 
 - `/api`
 - `/_next/static`
@@ -40,12 +69,8 @@ NODUS_SITE_KEY=site_xxx
 - `/sitemap.xml`
 - `/robots.txt`
 
-사이트 키가 설정되어 있으면 방문 이벤트를 전송합니다.
-
-- `session_id`
-- `last_page`
-- `current_page`
+필요하면 앱의 `middleware.ts`에서 `config`를 직접 정의해 덮어쓸 수 있습니다.
 
 ## 라이선스
 
-MIT
+MIT. 자세한 내용은 `LICENSE` 파일을 참고하세요.

package/dist/index.d.ts

@@ -1 +1 @@
-export { config, middleware } from "./next/middleware";
+export { nodus_proxy as middleware } from "./next/nodus_proxy";

package/dist/index.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.middleware = exports.config = void 0;
-var middleware_1 = require("./next/middleware");
-Object.defineProperty(exports, "config", { enumerable: true, get: function () { return middleware_1.config; } });
-Object.defineProperty(exports, "middleware", { enumerable: true, get: function () { return middleware_1.middleware; } });
+exports.middleware = void 0;
+var nodus_proxy_1 = require("./next/nodus_proxy");
+Object.defineProperty(exports, "middleware", { enumerable: true, get: function () { return nodus_proxy_1.nodus_proxy; } });

package/dist/logger/nodus-server-caller.d.ts

@@ -1,10 +1,7 @@
-export interface NodusBaseRequest {
-    session_id: string;
-}
-interface Prop<T extends NodusBaseRequest> {
+interface Prop<T> {
     data: T;
     url: string;
     key: string;
 }
-export declare function nodus_server_caller<T extends NodusBaseRequest>({ data, url, key }: Prop<T>): void;
+export declare function nodus_server_caller<T>({ data, url, key }: Prop<T>): void;
 export {};

package/dist/logger/nodus-server-caller.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.nodus_server_caller = nodus_server_caller;
 function nodus_server_caller({ data, url, key }) {
-    void fetch(`https://api.ministudiolab.com/sdk/${url}?key=${key}`, {
+    void fetch(`https://localhost:8080/sdk/${url}?key=${key}`, {
         method: "POST",
         headers: {
             "Content-Type": "application/json",

package/dist/logger/nodus-server-manager.d.ts

@@ -1,5 +1,4 @@
-import { NodusBaseRequest } from "./nodus-server-caller";
-export interface NodusVisitEventProp extends NodusBaseRequest {
+export interface NodusVisitEventProp {
     last_page: string;
     current_page: string;
 }

package/dist/next/nodus_proxy.d.ts

@@ -0,0 +1,3 @@
+import type { NextRequest } from "next/server";
+import { NextResponse } from "next/server";
+export declare function nodus_proxy(request: NextRequest): NextResponse<unknown>;

package/dist/next/{middleware.js → nodus_proxy.js}

@@ -1,25 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.config = void 0;
-exports.middleware = middleware;
+exports.nodus_proxy = nodus_proxy;
 const server_1 = require("next/server");
 const nodus_server_manager_1 = require("../logger/nodus-server-manager");
-const nodus_session_1 = require("../session/nodus-session");
-function middleware(request) {
+function nodus_proxy(request) {
     const response = server_1.NextResponse.next();
-    const sessionId = (0, nodus_session_1.nodus_cookie_manager)(request, response);
     const key = process.env.NODUS_SITE_KEY ?? process.env.NEXT_PUBLIC_NODUS_SITE_KEY;
     if (key) {
         (0, nodus_server_manager_1.nodus_visit_event)({
-            session_id: sessionId,
             last_page: request.headers.get("referer") || "",
             current_page: request.url,
         }, key);
     }
     return response;
 }
-exports.config = {
-    matcher: [
-        "/((?!api|_next/static|_next/image|favicon.ico|sitemap.xml|robots.txt).*)",
-    ],
-};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodus-lib/nodus",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/logger/nodus-base-request.js

@@ -1 +0,0 @@
-"use strict";

package/dist/next/middleware.d.ts

@@ -1,6 +0,0 @@
-import type { NextRequest } from "next/server";
-import { NextResponse } from "next/server";
-export declare function middleware(request: NextRequest): NextResponse<unknown>;
-export declare const config: {
-    matcher: string[];
-};

package/dist/session/nodus-session.d.ts

@@ -1,2 +0,0 @@
-import type { NextRequest, NextResponse } from "next/server";
-export declare function nodus_cookie_manager(request: NextRequest, response: NextResponse): string;

package/dist/session/nodus-session.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.nodus_cookie_manager = nodus_cookie_manager;
-const COOKIE_NAME = "nodus_session";
-const COOKIE_MAX_AGE_SECONDS = 60 * 60 * 24 * 365;
-function nodus_cookie_manager(request, response) {
-    const existingSession = request.cookies.get(COOKIE_NAME)?.value;
-    if (existingSession) {
-        return existingSession;
-    }
-    const sessionId = crypto.randomUUID();
-    response.cookies.set(COOKIE_NAME, sessionId, {
-        httpOnly: true,
-        sameSite: "lax",
-        secure: true,
-        path: "/",
-        maxAge: COOKIE_MAX_AGE_SECONDS,
-    });
-    return sessionId;
-}