@ahhaohho/event-publisher 0.1.1 → 0.2.0

package/README.md

@@ -134,6 +134,7 @@ payload에는 id와 작은 사실값만 싣는다. 닉네임·댓글 본문·썸
 | `ai.comment.created` | ai-chatbot | comment.service.ts | 봇 계정 | 게시자 |
 | `app.activity.challenge_viewed` | challenge | 챌린지 상세 API | 본인 | 본인 |
 | `app.activity.gallery_post_viewed` | gallery | 갤러리 상세 API | 본인 | 본인 |
+| `app.activity.session_active` | gallery, challenge | 인증된 앱 요청 (사용자당 ~10분 throttle, 박스별 중복 가능 → 소비자 debounce) | 본인 | 본인 |
 | `app.activity.post_step_viewed` | (POST /activity 수신 서버) | 앱 신호 | 본인 | 본인 |
 | `campaign.schedule.fired` | notification (Scheduler) | — | null | (비움) |
 
@@ -164,7 +165,7 @@ npm run build     # dist/
 - **CI** (`.github/workflows/ci.yml`): 모든 PR과 main push에서 Node 20·22로 typecheck → test → build → 패키지 파일 구성 검사.
 - **배포** (`.github/workflows/publish.yml`): **`package.json` version을 올린 PR을 main에 머지하면 배포된다.**
   1. main push 때 그 version이 npm에 없으면 publish한다. 이미 있으면 아무 것도 하지 않는다(일반 머지는 no-op).
-  2. 익명으로 레지스트리를 조회해 200인지 확인한다. 전파 지연을 고려해 10초 간격으로 6번까지 재시도하고, 그래도 아니면 실패 처리(private으로 나간 경우).
+  2. 익명으로 레지스트리를 조회해 200인지 확인한다. 전파 지연을 고려해 15초 간격으로 최대 5분 재시도하고, 그래도 아니면 실패 처리(private으로 나간 경우).
   3. `v{version}` 태그가 없으면 만든다. publish 여부와 무관하게 매번 확인하므로, 태그 push만 실패했거나 로컬에서 수동 publish한 버전도 다음 main push에서 태그가 생긴다.
 
 > 루트 CLAUDE.md의 "SDK 배포 워크플로우"(머지 후 `npm version` → 수동 `npm publish`)는 이 레포에 적용하지 않는다. main 직접 커밋·수동 publish 대신 버전 범프 PR을 머지한다. 수동 publish를 했더라도 워크플로는 skip + 태그만 만들므로 충돌은 없다.

package/dist/catalog/app-activity.d.ts

@@ -5,7 +5,9 @@ import { z } from 'zod';
  * - 서버가 API 호출에서 직접 아는 신호는 해당 서버가 발행한다 (challenge_viewed, gallery_post_viewed).
  * - 서버가 모르는 화면 단계 신호(post_step_viewed)만 앱이 `POST /activity`로 보내고, 받는 서버가 발행한다.
  * - userId는 항상 JWT 검증값이다. 요청 body/query의 userId를 쓰지 않는다.
- * - 단순 접속(lastActiveAt)은 요청마다 이벤트를 만들지 않고 Redis → DB로 따로 반영한다.
+ * - 단순 접속(lastActiveAt)은 session_active 이벤트로 반영한다. prod는 박스별 Redis라 서버 간에 접속 상태를
+ *   공유할 수 없어서, 발행 서버가 사용자당 약 10분 간격으로 throttle해 발행한다.
+ *   throttle이 박스별이므로 같은 사용자의 이벤트가 박스 수만큼 중복될 수 있고, 소비자가 debounce한다.
  */
 export declare const appActivityEvents: {
     'app.activity.challenge_viewed': import("../envelope").EventDefinition<z.ZodObject<{
@@ -17,6 +19,9 @@ export declare const appActivityEvents: {
         galleryId: z.ZodString;
         communityId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    'app.activity.session_active': import("../envelope").EventDefinition<z.ZodObject<{
+        userId: z.ZodString;
+    }, z.core.$strip>>;
     'app.activity.post_step_viewed': import("../envelope").EventDefinition<z.ZodObject<{
         userId: z.ZodString;
         stepId: z.ZodString;

package/dist/catalog/app-activity.js

@@ -9,7 +9,9 @@ const envelope_1 = require("../envelope");
  * - 서버가 API 호출에서 직접 아는 신호는 해당 서버가 발행한다 (challenge_viewed, gallery_post_viewed).
  * - 서버가 모르는 화면 단계 신호(post_step_viewed)만 앱이 `POST /activity`로 보내고, 받는 서버가 발행한다.
  * - userId는 항상 JWT 검증값이다. 요청 body/query의 userId를 쓰지 않는다.
- * - 단순 접속(lastActiveAt)은 요청마다 이벤트를 만들지 않고 Redis → DB로 따로 반영한다.
+ * - 단순 접속(lastActiveAt)은 session_active 이벤트로 반영한다. prod는 박스별 Redis라 서버 간에 접속 상태를
+ *   공유할 수 없어서, 발행 서버가 사용자당 약 10분 간격으로 throttle해 발행한다.
+ *   throttle이 박스별이므로 같은 사용자의 이벤트가 박스 수만큼 중복될 수 있고, 소비자가 debounce한다.
  */
 exports.appActivityEvents = {
     'app.activity.challenge_viewed': (0, envelope_1.defineEvent)({
@@ -35,6 +37,16 @@ exports.appActivityEvents = {
         actor: (p) => p.userId,
         subjects: (p) => [p.userId],
     }),
+    'app.activity.session_active': (0, envelope_1.defineEvent)({
+        version: 1,
+        publishers: ['ao-gallery-server', 'ao-challenge-server'],
+        description: '인증된 앱 요청 = 접속 신호 (S3 비활동 트리거 lastActiveAt). 발행 서버가 사용자당 약 10분 간격으로 throttle',
+        schema: zod_1.z.object({
+            userId: envelope_1.ids.userId,
+        }),
+        actor: (p) => p.userId,
+        subjects: (p) => [p.userId],
+    }),
     'app.activity.post_step_viewed': (0, envelope_1.defineEvent)({
         version: 1,
         // POST /activity를 받을 서버는 S3 카드(qSPjswwl)에서 확정 — 우선 notification-server로 둔다.

package/dist/catalog/index.d.ts

@@ -26,6 +26,9 @@ export declare const catalog: {
         galleryId: z.ZodString;
         communityId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    readonly 'app.activity.session_active': import("../envelope").EventDefinition<z.ZodObject<{
+        userId: z.ZodString;
+    }, z.core.$strip>>;
     readonly 'app.activity.post_step_viewed': import("../envelope").EventDefinition<z.ZodObject<{
         userId: z.ZodString;
         stepId: z.ZodString;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahhaohho/event-publisher",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "AhhaOhho 도메인 이벤트 발행 SDK — EventBridge envelope + Zod 이벤트 카탈로그",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",